Skip to content
Cloudflare API
Start here
API Reference
Magic Transit

Connectors

List Connectors
magic_transit.connectors.list(ConnectorListParams**kwargs) -> SyncSinglePage[ConnectorListResponse]
GET/accounts/{account_id}/magic/connectors
Fetch Connector
magic_transit.connectors.get(strconnector_id, ConnectorGetParams**kwargs) -> ConnectorGetResponse
GET/accounts/{account_id}/magic/connectors/{connector_id}
Add a connector to your account
magic_transit.connectors.create(ConnectorCreateParams**kwargs) -> ConnectorCreateResponse
POST/accounts/{account_id}/magic/connectors
Replace Connector or Re-provision License Key
magic_transit.connectors.update(strconnector_id, ConnectorUpdateParams**kwargs) -> ConnectorUpdateResponse
PUT/accounts/{account_id}/magic/connectors/{connector_id}
Edit Connector to update specific properties or Re-provision License Key
magic_transit.connectors.edit(strconnector_id, ConnectorEditParams**kwargs) -> ConnectorEditResponse
PATCH/accounts/{account_id}/magic/connectors/{connector_id}
Remove a connector from your account
magic_transit.connectors.delete(strconnector_id, ConnectorDeleteParams**kwargs) -> ConnectorDeleteResponse
DELETE/accounts/{account_id}/magic/connectors/{connector_id}
ModelsExpand Collapse
class ConnectorListResponse: …
id: str
activated: bool
interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]

Allowed days of the week for upgrades. Default is all days.

One of the following:
"Sunday"
"Monday"
"Tuesday"
"Wednesday"
"Thursday"
"Friday"
"Saturday"
interrupt_window_duration_hours: float
maximum24
minimum1
interrupt_window_embargo_dates: List[str]

List of dates (YYYY-MM-DD) when upgrades are blocked.

interrupt_window_hour_of_day: float
last_updated: str
notes: str
timezone: str
device: Optional[Device]
id: str
serial_number: Optional[str]
last_heartbeat: Optional[str]
last_seen_version: Optional[str]
license_key: Optional[str]
class ConnectorGetResponse: …
id: str
activated: bool
interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]

Allowed days of the week for upgrades. Default is all days.

One of the following:
"Sunday"
"Monday"
"Tuesday"
"Wednesday"
"Thursday"
"Friday"
"Saturday"
interrupt_window_duration_hours: float
maximum24
minimum1
interrupt_window_embargo_dates: List[str]

List of dates (YYYY-MM-DD) when upgrades are blocked.

interrupt_window_hour_of_day: float
last_updated: str
notes: str
timezone: str
device: Optional[Device]
id: str
serial_number: Optional[str]
last_heartbeat: Optional[str]
last_seen_version: Optional[str]
license_key: Optional[str]
class ConnectorCreateResponse: …
id: str
activated: bool
interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]

Allowed days of the week for upgrades. Default is all days.

One of the following:
"Sunday"
"Monday"
"Tuesday"
"Wednesday"
"Thursday"
"Friday"
"Saturday"
interrupt_window_duration_hours: float
maximum24
minimum1
interrupt_window_embargo_dates: List[str]

List of dates (YYYY-MM-DD) when upgrades are blocked.

interrupt_window_hour_of_day: float
last_updated: str
notes: str
timezone: str
device: Optional[Device]
id: str
serial_number: Optional[str]
last_heartbeat: Optional[str]
last_seen_version: Optional[str]
license_key: Optional[str]
class ConnectorUpdateResponse: …
id: str
activated: bool
interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]

Allowed days of the week for upgrades. Default is all days.

One of the following:
"Sunday"
"Monday"
"Tuesday"
"Wednesday"
"Thursday"
"Friday"
"Saturday"
interrupt_window_duration_hours: float
maximum24
minimum1
interrupt_window_embargo_dates: List[str]

List of dates (YYYY-MM-DD) when upgrades are blocked.

interrupt_window_hour_of_day: float
last_updated: str
notes: str
timezone: str
device: Optional[Device]
id: str
serial_number: Optional[str]
last_heartbeat: Optional[str]
last_seen_version: Optional[str]
license_key: Optional[str]
class ConnectorEditResponse: …
id: str
activated: bool
interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]

Allowed days of the week for upgrades. Default is all days.

One of the following:
"Sunday"
"Monday"
"Tuesday"
"Wednesday"
"Thursday"
"Friday"
"Saturday"
interrupt_window_duration_hours: float
maximum24
minimum1
interrupt_window_embargo_dates: List[str]

List of dates (YYYY-MM-DD) when upgrades are blocked.

interrupt_window_hour_of_day: float
last_updated: str
notes: str
timezone: str
device: Optional[Device]
id: str
serial_number: Optional[str]
last_heartbeat: Optional[str]
last_seen_version: Optional[str]
license_key: Optional[str]
class ConnectorDeleteResponse: …
id: str
activated: bool
interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]

Allowed days of the week for upgrades. Default is all days.

One of the following:
"Sunday"
"Monday"
"Tuesday"
"Wednesday"
"Thursday"
"Friday"
"Saturday"
interrupt_window_duration_hours: float
maximum24
minimum1
interrupt_window_embargo_dates: List[str]

List of dates (YYYY-MM-DD) when upgrades are blocked.

interrupt_window_hour_of_day: float
last_updated: str
notes: str
timezone: str
device: Optional[Device]
id: str
serial_number: Optional[str]
last_heartbeat: Optional[str]
last_seen_version: Optional[str]
license_key: Optional[str]

ConnectorsEvents

List Events
magic_transit.connectors.events.list(strconnector_id, EventListParams**kwargs) -> EventListResponse
GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/events
Get Event
magic_transit.connectors.events.get(floatevent_n, EventGetParams**kwargs) -> EventGetResponse
GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/events/{event_t}.{event_n}
ModelsExpand Collapse
class EventListResponse: …
count: float
items: List[Item]
a: float

Time the Event was collected (seconds since the Unix epoch)

k: str

Kind

n: float

Sequence number, used to order events with the same timestamp

t: float

Time the Event was recorded (seconds since the Unix epoch)

cursor: Optional[str]
class EventGetResponse: …

Recorded Event

e: E
One of the following:
class EInit: …
k: Literal["Init"]

Initialized process

class ELeave: …
k: Literal["Leave"]

Stopped process

class EStartAttestation: …
k: Literal["StartAttestation"]

Started attestation

class EFinishAttestationSuccess: …
k: Literal["FinishAttestationSuccess"]

Finished attestation

class EFinishAttestationFailure: …
k: Literal["FinishAttestationFailure"]

Failed attestation

class EStartRotateCryptKey: …
k: Literal["StartRotateCryptKey"]

Started crypt key rotation

class EFinishRotateCryptKeySuccess: …
k: Literal["FinishRotateCryptKeySuccess"]

Finished crypt key rotation

class EFinishRotateCryptKeyFailure: …
k: Literal["FinishRotateCryptKeyFailure"]

Failed crypt key rotation

class EStartRotatePki: …
k: Literal["StartRotatePki"]

Started PKI rotation

class EFinishRotatePkiSuccess: …
k: Literal["FinishRotatePkiSuccess"]

Finished PKI rotation

class EFinishRotatePkiFailure: …
k: Literal["FinishRotatePkiFailure"]

Failed PKI rotation

class EStartUpgrade: …
k: Literal["StartUpgrade"]

Started upgrade

url: str

Location of upgrade bundle

class EFinishUpgradeSuccess: …
k: Literal["FinishUpgradeSuccess"]

Finished upgrade

class EFinishUpgradeFailure: …
k: Literal["FinishUpgradeFailure"]

Failed upgrade

class EReconcile: …
k: Literal["Reconcile"]

Reconciled

class EConfigureCloudflaredTunnel: …
k: Literal["ConfigureCloudflaredTunnel"]

Configured Cloudflared tunnel

n: float

Sequence number, used to order events with the same timestamp

t: float

Time the Event was recorded (seconds since the Unix epoch)

v: Optional[str]

Version

ConnectorsEventsLatest

Get latest Events
magic_transit.connectors.events.latest.list(strconnector_id, LatestListParams**kwargs) -> LatestListResponse
GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/events/latest
ModelsExpand Collapse
class LatestListResponse: …
count: float
items: List[Item]
e: ItemE
One of the following:
class ItemEInit: …
k: Literal["Init"]

Initialized process

class ItemELeave: …
k: Literal["Leave"]

Stopped process

class ItemEStartAttestation: …
k: Literal["StartAttestation"]

Started attestation

class ItemEFinishAttestationSuccess: …
k: Literal["FinishAttestationSuccess"]

Finished attestation

class ItemEFinishAttestationFailure: …
k: Literal["FinishAttestationFailure"]

Failed attestation

class ItemEStartRotateCryptKey: …
k: Literal["StartRotateCryptKey"]

Started crypt key rotation

class ItemEFinishRotateCryptKeySuccess: …
k: Literal["FinishRotateCryptKeySuccess"]

Finished crypt key rotation

class ItemEFinishRotateCryptKeyFailure: …
k: Literal["FinishRotateCryptKeyFailure"]

Failed crypt key rotation

class ItemEStartRotatePki: …
k: Literal["StartRotatePki"]

Started PKI rotation

class ItemEFinishRotatePkiSuccess: …
k: Literal["FinishRotatePkiSuccess"]

Finished PKI rotation

class ItemEFinishRotatePkiFailure: …
k: Literal["FinishRotatePkiFailure"]

Failed PKI rotation

class ItemEStartUpgrade: …
k: Literal["StartUpgrade"]

Started upgrade

url: str

Location of upgrade bundle

class ItemEFinishUpgradeSuccess: …
k: Literal["FinishUpgradeSuccess"]

Finished upgrade

class ItemEFinishUpgradeFailure: …
k: Literal["FinishUpgradeFailure"]

Failed upgrade

class ItemEReconcile: …
k: Literal["Reconcile"]

Reconciled

class ItemEConfigureCloudflaredTunnel: …
k: Literal["ConfigureCloudflaredTunnel"]

Configured Cloudflared tunnel

n: float

Sequence number, used to order events with the same timestamp

t: float

Time the Event was recorded (seconds since the Unix epoch)

v: Optional[str]

Version

ConnectorsSnapshots

List Snapshots
magic_transit.connectors.snapshots.list(strconnector_id, SnapshotListParams**kwargs) -> SnapshotListResponse
GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/snapshots
Get Snapshot
magic_transit.connectors.snapshots.get(floatsnapshot_t, SnapshotGetParams**kwargs) -> SnapshotGetResponse
GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/snapshots/{snapshot_t}
ModelsExpand Collapse
class SnapshotListResponse: …
count: float
items: List[Item]
a: float

Time the Snapshot was collected (seconds since the Unix epoch)

t: float

Time the Snapshot was recorded (seconds since the Unix epoch)

cursor: Optional[str]
class SnapshotGetResponse: …

Snapshot

count_reclaim_failures: float

Count of failures to reclaim space

count_reclaimed_paths: float

Count of reclaimed paths

count_record_failed: float

Count of failed snapshot recordings

count_transmit_failures: float

Count of failed snapshot transmissions

t: float

Time the Snapshot was recorded (seconds since the Unix epoch)

v: str

Version

bonds: Optional[List[Bond]]
name: str

Name of the network interface

status: str

Current status of the network interface

cpu_count: Optional[float]

Count of processors/cores

cpu_pressure_10s: Optional[float]

Percentage of time over a 10 second window that tasks were stalled

cpu_pressure_300s: Optional[float]

Percentage of time over a 5 minute window that tasks were stalled

cpu_pressure_60s: Optional[float]

Percentage of time over a 1 minute window that tasks were stalled

cpu_pressure_total_us: Optional[float]

Total stall time (microseconds)

cpu_time_guest_ms: Optional[float]

Time spent running a virtual CPU or guest OS (milliseconds)

cpu_time_guest_nice_ms: Optional[float]

Time spent running a niced guest (milliseconds)

cpu_time_idle_ms: Optional[float]

Time spent in idle state (milliseconds)

cpu_time_iowait_ms: Optional[float]

Time spent wait for I/O to complete (milliseconds)

cpu_time_irq_ms: Optional[float]

Time spent servicing interrupts (milliseconds)

cpu_time_nice_ms: Optional[float]

Time spent in low-priority user mode (milliseconds)

cpu_time_softirq_ms: Optional[float]

Time spent servicing softirqs (milliseconds)

cpu_time_steal_ms: Optional[float]

Time stolen (milliseconds)

cpu_time_system_ms: Optional[float]

Time spent in system mode (milliseconds)

cpu_time_user_ms: Optional[float]

Time spent in user mode (milliseconds)

delta: Optional[float]

Number of network operations applied during state transition

dhcp_leases: Optional[List[DHCPLease]]
client_id: str

Client ID of the device the IP Address was leased to

expiry_time: float

Expiry time of the DHCP lease (seconds since the Unix epoch)

hostname: str

Hostname of the device the IP Address was leased to

interface_name: str

Name of the network interface

ip_address: str

IP Address that was leased

mac_address: str

MAC Address of the device the IP Address was leased to

disks: Optional[List[Disk]]
in_progress: float

I/Os currently in progress

major: float

Device major number

merged: float

Reads merged

minor: float

Device minor number

name: str

Device name

reads: float

Reads completed successfully

sectors_read: float

Sectors read successfully

sectors_written: float

Sectors written successfully

time_in_progress_ms: float

Time spent doing I/Os (milliseconds)

time_reading_ms: float

Time spent reading (milliseconds)

time_writing_ms: float

Time spent writing (milliseconds)

weighted_time_in_progress_ms: float

Weighted time spent doing I/Os (milliseconds)

writes: float

Writes completed

writes_merged: float

Writes merged

discards: Optional[float]

Discards completed successfully

discards_merged: Optional[float]

Discards merged

flushes: Optional[float]

Flushes completed successfully

sectors_discarded: Optional[float]

Sectors discarded

time_discarding_ms: Optional[float]

Time spent discarding (milliseconds)

time_flushing_ms: Optional[float]

Time spent flushing (milliseconds)

epsilon: Optional[float]

Simulated number of network operations applied during state transition

ha_state: Optional[str]

Name of high availability state

ha_value: Optional[float]

Numeric value associated with high availability state (0 = disabled, 1 = active, 2 = standby, 3 = stopped, 4 = fault)

interfaces: Optional[List[Interface]]
name: str

Name of the network interface

operstate: str

UP/DOWN state of the network interface

ip_addresses: Optional[List[InterfaceIPAddress]]
interface_name: str

Name of the network interface

ip_address: str

IP address of the network interface

speed: Optional[float]

Speed of the network interface (bits per second)

io_pressure_full_10s: Optional[float]

Percentage of time over a 10 second window that all tasks were stalled

io_pressure_full_300s: Optional[float]

Percentage of time over a 5 minute window that all tasks were stalled

io_pressure_full_60s: Optional[float]

Percentage of time over a 1 minute window that all tasks were stalled

io_pressure_full_total_us: Optional[float]

Total stall time (microseconds)

io_pressure_some_10s: Optional[float]

Percentage of time over a 10 second window that some tasks were stalled

io_pressure_some_300s: Optional[float]

Percentage of time over a 3 minute window that some tasks were stalled

io_pressure_some_60s: Optional[float]

Percentage of time over a 1 minute window that some tasks were stalled

io_pressure_some_total_us: Optional[float]

Total stall time (microseconds)

kernel_btime: Optional[float]

Boot time (seconds since Unix epoch)

kernel_ctxt: Optional[float]

Number of context switches that the system underwent

kernel_processes: Optional[float]

Number of forks since boot

kernel_processes_blocked: Optional[float]

Number of processes blocked waiting for I/O

kernel_processes_running: Optional[float]

Number of processes in runnable state

load_average_15m: Optional[float]

The fifteen-minute load average

load_average_1m: Optional[float]

The one-minute load average

load_average_5m: Optional[float]

The five-minute load average

load_average_cur: Optional[float]

Number of currently runnable kernel scheduling entities

load_average_max: Optional[float]

Number of kernel scheduling entities that currently exist on the system

memory_active_bytes: Optional[float]

Memory that has been used more recently

memory_anon_hugepages_bytes: Optional[float]

Non-file backed huge pages mapped into user-space page tables

memory_anon_pages_bytes: Optional[float]

Non-file backed pages mapped into user-space page tables

memory_available_bytes: Optional[float]

Estimate of how much memory is available for starting new applications

memory_bounce_bytes: Optional[float]

Memory used for block device bounce buffers

memory_buffers_bytes: Optional[float]

Relatively temporary storage for raw disk blocks

memory_cached_bytes: Optional[float]

In-memory cache for files read from the disk

memory_cma_free_bytes: Optional[float]

Free CMA (Contiguous Memory Allocator) pages

memory_cma_total_bytes: Optional[float]

Total CMA (Contiguous Memory Allocator) pages

memory_commit_limit_bytes: Optional[float]

Total amount of memory currently available to be allocated on the system

memory_committed_as_bytes: Optional[float]

Amount of memory presently allocated on the system

memory_dirty_bytes: Optional[float]

Memory which is waiting to get written back to the disk

memory_free_bytes: Optional[float]

The sum of LowFree and HighFree

memory_high_free_bytes: Optional[float]

Amount of free highmem

memory_high_total_bytes: Optional[float]

Total amount of highmem

memory_hugepages_free: Optional[float]

The number of huge pages in the pool that are not yet allocated

memory_hugepages_rsvd: Optional[float]

Number of huge pages for which a commitment has been made, but no allocation has yet been made

memory_hugepages_surp: Optional[float]

Number of huge pages in the pool above the threshold

memory_hugepages_total: Optional[float]

The size of the pool of huge pages

memory_hugepagesize_bytes: Optional[float]

The size of huge pages

memory_inactive_bytes: Optional[float]

Memory which has been less recently used

memory_k_reclaimable_bytes: Optional[float]

Kernel allocations that the kernel will attempt to reclaim under memory pressure

memory_kernel_stack_bytes: Optional[float]

Amount of memory allocated to kernel stacks

memory_low_free_bytes: Optional[float]

Amount of free lowmem

memory_low_total_bytes: Optional[float]

Total amount of lowmem

memory_mapped_bytes: Optional[float]

Files which have been mapped into memory

memory_page_tables_bytes: Optional[float]

Amount of memory dedicated to the lowest level of page tables

memory_per_cpu_bytes: Optional[float]

Memory allocated to the per-cpu alloctor used to back per-cpu allocations

memory_pressure_full_10s: Optional[float]

Percentage of time over a 10 second window that all tasks were stalled

memory_pressure_full_300s: Optional[float]

Percentage of time over a 5 minute window that all tasks were stalled

memory_pressure_full_60s: Optional[float]

Percentage of time over a 1 minute window that all tasks were stalled

memory_pressure_full_total_us: Optional[float]

Total stall time (microseconds)

memory_pressure_some_10s: Optional[float]

Percentage of time over a 10 second window that some tasks were stalled

memory_pressure_some_300s: Optional[float]

Percentage of time over a 5 minute window that some tasks were stalled

memory_pressure_some_60s: Optional[float]

Percentage of time over a 1 minute window that some tasks were stalled

memory_pressure_some_total_us: Optional[float]

Total stall time (microseconds)

memory_s_reclaimable_bytes: Optional[float]

Part of slab that can be reclaimed on memory pressure

memory_s_unreclaim_bytes: Optional[float]

Part of slab that cannot be reclaimed on memory pressure

memory_secondary_page_tables_bytes: Optional[float]

Amount of memory dedicated to the lowest level of page tables

memory_shmem_bytes: Optional[float]

Amount of memory consumed by tmpfs

memory_shmem_hugepages_bytes: Optional[float]

Memory used by shmem and tmpfs, allocated with huge pages

memory_shmem_pmd_mapped_bytes: Optional[float]

Shared memory mapped into user space with huge pages

memory_slab_bytes: Optional[float]

In-kernel data structures cache

memory_swap_cached_bytes: Optional[float]

Memory swapped out and back in while still in swap file

memory_swap_free_bytes: Optional[float]

Amount of swap space that is currently unused

memory_swap_total_bytes: Optional[float]

Total amount of swap space available

memory_total_bytes: Optional[float]

Total usable RAM

memory_vmalloc_chunk_bytes: Optional[float]

Largest contiguous block of vmalloc area which is free

memory_vmalloc_total_bytes: Optional[float]

Total size of vmalloc memory area

memory_vmalloc_used_bytes: Optional[float]

Amount of vmalloc area which is used

memory_writeback_bytes: Optional[float]

Memory which is actively being written back to the disk

memory_writeback_tmp_bytes: Optional[float]

Memory used by FUSE for temporary writeback buffers

memory_z_swap_bytes: Optional[float]

Memory consumed by the zswap backend, compressed

memory_z_swapped_bytes: Optional[float]

Amount of anonymous memory stored in zswap, uncompressed

mounts: Optional[List[Mount]]
file_system: str

File system on disk (EXT4, NTFS, etc.)

kind: str

Kind of disk (HDD, SSD, etc.)

mount_point: str

Path where disk is mounted

name: str

Name of the disk mount

available_bytes: Optional[float]

Available disk size (bytes)

is_read_only: Optional[bool]

Determines whether the disk is read-only

is_removable: Optional[bool]

Determines whether the disk is removable

total_bytes: Optional[float]

Total disk size (bytes)

netdevs: Optional[List[Netdev]]
name: str

Name of the network device

recv_bytes: float

Total bytes received

recv_compressed: float

Compressed packets received

recv_drop: float

Packets dropped

recv_errs: float

Bad packets received

recv_fifo: float

FIFO overruns

recv_frame: float

Frame alignment errors

recv_multicast: float

Multicast packets received

recv_packets: float

Total packets received

sent_bytes: float

Total bytes transmitted

sent_carrier: float

Number of packets not sent due to carrier errors

sent_colls: float

Number of collisions

sent_compressed: float

Number of compressed packets transmitted

sent_drop: float

Number of packets dropped during transmission

sent_errs: float

Number of transmission errors

sent_fifo: float

FIFO overruns

sent_packets: float

Total packets transmitted

snmp_icmp_in_addr_mask_reps: Optional[float]

Number of ICMP Address Mask Reply messages received

snmp_icmp_in_addr_masks: Optional[float]

Number of ICMP Address Mask Request messages received

snmp_icmp_in_csum_errors: Optional[float]

Number of ICMP messages received with bad checksums

snmp_icmp_in_dest_unreachs: Optional[float]

Number of ICMP Destination Unreachable messages received

snmp_icmp_in_echo_reps: Optional[float]

Number of ICMP Echo Reply messages received

snmp_icmp_in_echos: Optional[float]

Number of ICMP Echo (request) messages received

snmp_icmp_in_errors: Optional[float]

Number of ICMP messages received with ICMP-specific errors

snmp_icmp_in_msgs: Optional[float]

Number of ICMP messages received

snmp_icmp_in_parm_probs: Optional[float]

Number of ICMP Parameter Problem messages received

snmp_icmp_in_redirects: Optional[float]

Number of ICMP Redirect messages received

snmp_icmp_in_src_quenchs: Optional[float]

Number of ICMP Source Quench messages received

snmp_icmp_in_time_excds: Optional[float]

Number of ICMP Time Exceeded messages received

snmp_icmp_in_timestamp_reps: Optional[float]

Number of ICMP Address Mask Request messages received

snmp_icmp_in_timestamps: Optional[float]

Number of ICMP Timestamp (request) messages received

snmp_icmp_out_addr_mask_reps: Optional[float]

Number of ICMP Address Mask Reply messages sent

snmp_icmp_out_addr_masks: Optional[float]

Number of ICMP Address Mask Request messages sent

snmp_icmp_out_dest_unreachs: Optional[float]

Number of ICMP Destination Unreachable messages sent

snmp_icmp_out_echo_reps: Optional[float]

Number of ICMP Echo Reply messages sent

snmp_icmp_out_echos: Optional[float]

Number of ICMP Echo (request) messages sent

snmp_icmp_out_errors: Optional[float]

Number of ICMP messages which this entity did not send due to ICMP-specific errors

snmp_icmp_out_msgs: Optional[float]

Number of ICMP messages attempted to send

snmp_icmp_out_parm_probs: Optional[float]

Number of ICMP Parameter Problem messages sent

snmp_icmp_out_redirects: Optional[float]

Number of ICMP Redirect messages sent

snmp_icmp_out_src_quenchs: Optional[float]

Number of ICMP Source Quench messages sent

snmp_icmp_out_time_excds: Optional[float]

Number of ICMP Time Exceeded messages sent

snmp_icmp_out_timestamp_reps: Optional[float]

Number of ICMP Timestamp Reply messages sent

snmp_icmp_out_timestamps: Optional[float]

Number of ICMP Timestamp (request) messages sent

snmp_ip_default_ttl: Optional[float]

Default value of the Time-To-Live field of the IP header

snmp_ip_forw_datagrams: Optional[float]

Number of datagrams forwarded to their final destination

snmp_ip_forwarding_enabled: Optional[bool]

Set when acting as an IP gateway

snmp_ip_frag_creates: Optional[float]

Number of datagrams generated by fragmentation

snmp_ip_frag_fails: Optional[float]

Number of datagrams discarded because fragmentation failed

snmp_ip_frag_oks: Optional[float]

Number of datagrams successfully fragmented

snmp_ip_in_addr_errors: Optional[float]

Number of input datagrams discarded due to errors in the IP address

snmp_ip_in_delivers: Optional[float]

Number of input datagrams successfully delivered to IP user-protocols

snmp_ip_in_discards: Optional[float]

Number of input datagrams otherwise discarded

snmp_ip_in_hdr_errors: Optional[float]

Number of input datagrams discarded due to errors in the IP header

snmp_ip_in_receives: Optional[float]

Number of input datagrams received from interfaces

snmp_ip_in_unknown_protos: Optional[float]

Number of input datagrams discarded due unknown or unsupported protocol

snmp_ip_out_discards: Optional[float]

Number of output datagrams otherwise discarded

snmp_ip_out_no_routes: Optional[float]

Number of output datagrams discarded because no route matched

snmp_ip_out_requests: Optional[float]

Number of datagrams supplied for transmission

snmp_ip_reasm_fails: Optional[float]

Number of failures detected by the reassembly algorithm

snmp_ip_reasm_oks: Optional[float]

Number of datagrams successfully reassembled

snmp_ip_reasm_reqds: Optional[float]

Number of fragments received which needed to be reassembled

snmp_ip_reasm_timeout: Optional[float]

Number of seconds fragments are held while awaiting reassembly

snmp_tcp_active_opens: Optional[float]

Number of times TCP transitions to SYN-SENT from CLOSED

snmp_tcp_attempt_fails: Optional[float]

Number of times TCP transitions to CLOSED from SYN-SENT or SYN-RCVD, plus transitions to LISTEN from SYN-RCVD

snmp_tcp_curr_estab: Optional[float]

Number of TCP connections in ESTABLISHED or CLOSE-WAIT

snmp_tcp_estab_resets: Optional[float]

Number of times TCP transitions to CLOSED from ESTABLISHED or CLOSE-WAIT

snmp_tcp_in_csum_errors: Optional[float]

Number of TCP segments received with checksum errors

snmp_tcp_in_errs: Optional[float]

Number of TCP segments received in error

snmp_tcp_in_segs: Optional[float]

Number of TCP segments received

snmp_tcp_max_conn: Optional[float]

Limit on the total number of TCP connections

snmp_tcp_out_rsts: Optional[float]

Number of TCP segments sent with RST flag

snmp_tcp_out_segs: Optional[float]

Number of TCP segments sent

snmp_tcp_passive_opens: Optional[float]

Number of times TCP transitions to SYN-RCVD from LISTEN

snmp_tcp_retrans_segs: Optional[float]

Number of TCP segments retransmitted

snmp_tcp_rto_max: Optional[float]

Maximum value permitted by a TCP implementation for the retransmission timeout (milliseconds)

snmp_tcp_rto_min: Optional[float]

Minimum value permitted by a TCP implementation for the retransmission timeout (milliseconds)

snmp_udp_in_datagrams: Optional[float]

Number of UDP datagrams delivered to UDP applications

snmp_udp_in_errors: Optional[float]

Number of UDP datagrams failed to be delivered for reasons other than lack of application at the destination port

snmp_udp_no_ports: Optional[float]

Number of UDP datagrams received for which there was not application at the destination port

snmp_udp_out_datagrams: Optional[float]

Number of UDP datagrams sent

system_boot_time_s: Optional[float]

Boottime of the system (seconds since the Unix epoch)

thermals: Optional[List[Thermal]]
label: str

Sensor identifier for the component

critical_celcius: Optional[float]

Critical failure temperature of the component (degrees Celsius)

current_celcius: Optional[float]

Current temperature of the component (degrees Celsius)

max_celcius: Optional[float]

Maximum temperature of the component (degrees Celsius)

tunnels: Optional[List[Tunnel]]
health_state: str

Name of tunnel health state (unknown, healthy, degraded, down)

health_value: float

Numeric value associated with tunnel state (0 = unknown, 1 = healthy, 2 = degraded, 3 = down)

interface_name: str

The tunnel interface name (i.e. xfrm1, xfrm3.99, etc.)

tunnel_id: str

Tunnel identifier

probed_mtu: Optional[float]

MTU as measured between the two ends of the tunnel

recent_healthy_pings: Optional[float]

Number of recent healthy pings for this tunnel

recent_unhealthy_pings: Optional[float]

Number of recent unhealthy pings for this tunnel

uptime_idle_ms: Optional[float]

Sum of how much time each core has spent idle

uptime_total_ms: Optional[float]

Uptime of the system, including time spent in suspend

ConnectorsSnapshotsLatest

Get latest Snapshots
magic_transit.connectors.snapshots.latest.list(strconnector_id, LatestListParams**kwargs) -> LatestListResponse
GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/snapshots/latest
ModelsExpand Collapse
class LatestListResponse: …
count: float
items: List[Item]
count_reclaim_failures: float

Count of failures to reclaim space

count_reclaimed_paths: float

Count of reclaimed paths

count_record_failed: float

Count of failed snapshot recordings

count_transmit_failures: float

Count of failed snapshot transmissions

t: float

Time the Snapshot was recorded (seconds since the Unix epoch)

v: str

Version

bonds: Optional[List[ItemBond]]
name: str

Name of the network interface

status: str

Current status of the network interface

cpu_count: Optional[float]

Count of processors/cores

cpu_pressure_10s: Optional[float]

Percentage of time over a 10 second window that tasks were stalled

cpu_pressure_300s: Optional[float]

Percentage of time over a 5 minute window that tasks were stalled

cpu_pressure_60s: Optional[float]

Percentage of time over a 1 minute window that tasks were stalled

cpu_pressure_total_us: Optional[float]

Total stall time (microseconds)

cpu_time_guest_ms: Optional[float]

Time spent running a virtual CPU or guest OS (milliseconds)

cpu_time_guest_nice_ms: Optional[float]

Time spent running a niced guest (milliseconds)

cpu_time_idle_ms: Optional[float]

Time spent in idle state (milliseconds)

cpu_time_iowait_ms: Optional[float]

Time spent wait for I/O to complete (milliseconds)

cpu_time_irq_ms: Optional[float]

Time spent servicing interrupts (milliseconds)

cpu_time_nice_ms: Optional[float]

Time spent in low-priority user mode (milliseconds)

cpu_time_softirq_ms: Optional[float]

Time spent servicing softirqs (milliseconds)

cpu_time_steal_ms: Optional[float]

Time stolen (milliseconds)

cpu_time_system_ms: Optional[float]

Time spent in system mode (milliseconds)

cpu_time_user_ms: Optional[float]

Time spent in user mode (milliseconds)

delta: Optional[float]

Number of network operations applied during state transition

dhcp_leases: Optional[List[ItemDHCPLease]]
client_id: str

Client ID of the device the IP Address was leased to

expiry_time: float

Expiry time of the DHCP lease (seconds since the Unix epoch)

hostname: str

Hostname of the device the IP Address was leased to

interface_name: str

Name of the network interface

ip_address: str

IP Address that was leased

mac_address: str

MAC Address of the device the IP Address was leased to

disks: Optional[List[ItemDisk]]
in_progress: float

I/Os currently in progress

major: float

Device major number

merged: float

Reads merged

minor: float

Device minor number

name: str

Device name

reads: float

Reads completed successfully

sectors_read: float

Sectors read successfully

sectors_written: float

Sectors written successfully

time_in_progress_ms: float

Time spent doing I/Os (milliseconds)

time_reading_ms: float

Time spent reading (milliseconds)

time_writing_ms: float

Time spent writing (milliseconds)

weighted_time_in_progress_ms: float

Weighted time spent doing I/Os (milliseconds)

writes: float

Writes completed

writes_merged: float

Writes merged

discards: Optional[float]

Discards completed successfully

discards_merged: Optional[float]

Discards merged

flushes: Optional[float]

Flushes completed successfully

sectors_discarded: Optional[float]

Sectors discarded

time_discarding_ms: Optional[float]

Time spent discarding (milliseconds)

time_flushing_ms: Optional[float]

Time spent flushing (milliseconds)

epsilon: Optional[float]

Simulated number of network operations applied during state transition

ha_state: Optional[str]

Name of high availability state

ha_value: Optional[float]

Numeric value associated with high availability state (0 = disabled, 1 = active, 2 = standby, 3 = stopped, 4 = fault)

interfaces: Optional[List[ItemInterface]]
name: str

Name of the network interface

operstate: str

UP/DOWN state of the network interface

ip_addresses: Optional[List[ItemInterfaceIPAddress]]
interface_name: str

Name of the network interface

ip_address: str

IP address of the network interface

speed: Optional[float]

Speed of the network interface (bits per second)

io_pressure_full_10s: Optional[float]

Percentage of time over a 10 second window that all tasks were stalled

io_pressure_full_300s: Optional[float]

Percentage of time over a 5 minute window that all tasks were stalled

io_pressure_full_60s: Optional[float]

Percentage of time over a 1 minute window that all tasks were stalled

io_pressure_full_total_us: Optional[float]

Total stall time (microseconds)

io_pressure_some_10s: Optional[float]

Percentage of time over a 10 second window that some tasks were stalled

io_pressure_some_300s: Optional[float]

Percentage of time over a 3 minute window that some tasks were stalled

io_pressure_some_60s: Optional[float]

Percentage of time over a 1 minute window that some tasks were stalled

io_pressure_some_total_us: Optional[float]

Total stall time (microseconds)

kernel_btime: Optional[float]

Boot time (seconds since Unix epoch)

kernel_ctxt: Optional[float]

Number of context switches that the system underwent

kernel_processes: Optional[float]

Number of forks since boot

kernel_processes_blocked: Optional[float]

Number of processes blocked waiting for I/O

kernel_processes_running: Optional[float]

Number of processes in runnable state

load_average_15m: Optional[float]

The fifteen-minute load average

load_average_1m: Optional[float]

The one-minute load average

load_average_5m: Optional[float]

The five-minute load average

load_average_cur: Optional[float]

Number of currently runnable kernel scheduling entities

load_average_max: Optional[float]

Number of kernel scheduling entities that currently exist on the system

memory_active_bytes: Optional[float]

Memory that has been used more recently

memory_anon_hugepages_bytes: Optional[float]

Non-file backed huge pages mapped into user-space page tables

memory_anon_pages_bytes: Optional[float]

Non-file backed pages mapped into user-space page tables

memory_available_bytes: Optional[float]

Estimate of how much memory is available for starting new applications

memory_bounce_bytes: Optional[float]

Memory used for block device bounce buffers

memory_buffers_bytes: Optional[float]

Relatively temporary storage for raw disk blocks

memory_cached_bytes: Optional[float]

In-memory cache for files read from the disk

memory_cma_free_bytes: Optional[float]

Free CMA (Contiguous Memory Allocator) pages

memory_cma_total_bytes: Optional[float]

Total CMA (Contiguous Memory Allocator) pages

memory_commit_limit_bytes: Optional[float]

Total amount of memory currently available to be allocated on the system

memory_committed_as_bytes: Optional[float]

Amount of memory presently allocated on the system

memory_dirty_bytes: Optional[float]

Memory which is waiting to get written back to the disk

memory_free_bytes: Optional[float]

The sum of LowFree and HighFree

memory_high_free_bytes: Optional[float]

Amount of free highmem

memory_high_total_bytes: Optional[float]

Total amount of highmem

memory_hugepages_free: Optional[float]

The number of huge pages in the pool that are not yet allocated

memory_hugepages_rsvd: Optional[float]

Number of huge pages for which a commitment has been made, but no allocation has yet been made

memory_hugepages_surp: Optional[float]

Number of huge pages in the pool above the threshold

memory_hugepages_total: Optional[float]

The size of the pool of huge pages

memory_hugepagesize_bytes: Optional[float]

The size of huge pages

memory_inactive_bytes: Optional[float]

Memory which has been less recently used

memory_k_reclaimable_bytes: Optional[float]

Kernel allocations that the kernel will attempt to reclaim under memory pressure

memory_kernel_stack_bytes: Optional[float]

Amount of memory allocated to kernel stacks

memory_low_free_bytes: Optional[float]

Amount of free lowmem

memory_low_total_bytes: Optional[float]

Total amount of lowmem

memory_mapped_bytes: Optional[float]

Files which have been mapped into memory

memory_page_tables_bytes: Optional[float]

Amount of memory dedicated to the lowest level of page tables

memory_per_cpu_bytes: Optional[float]

Memory allocated to the per-cpu alloctor used to back per-cpu allocations

memory_pressure_full_10s: Optional[float]

Percentage of time over a 10 second window that all tasks were stalled

memory_pressure_full_300s: Optional[float]

Percentage of time over a 5 minute window that all tasks were stalled

memory_pressure_full_60s: Optional[float]

Percentage of time over a 1 minute window that all tasks were stalled

memory_pressure_full_total_us: Optional[float]

Total stall time (microseconds)

memory_pressure_some_10s: Optional[float]

Percentage of time over a 10 second window that some tasks were stalled

memory_pressure_some_300s: Optional[float]

Percentage of time over a 5 minute window that some tasks were stalled

memory_pressure_some_60s: Optional[float]

Percentage of time over a 1 minute window that some tasks were stalled

memory_pressure_some_total_us: Optional[float]

Total stall time (microseconds)

memory_s_reclaimable_bytes: Optional[float]

Part of slab that can be reclaimed on memory pressure

memory_s_unreclaim_bytes: Optional[float]

Part of slab that cannot be reclaimed on memory pressure

memory_secondary_page_tables_bytes: Optional[float]

Amount of memory dedicated to the lowest level of page tables

memory_shmem_bytes: Optional[float]

Amount of memory consumed by tmpfs

memory_shmem_hugepages_bytes: Optional[float]

Memory used by shmem and tmpfs, allocated with huge pages

memory_shmem_pmd_mapped_bytes: Optional[float]

Shared memory mapped into user space with huge pages

memory_slab_bytes: Optional[float]

In-kernel data structures cache

memory_swap_cached_bytes: Optional[float]

Memory swapped out and back in while still in swap file

memory_swap_free_bytes: Optional[float]

Amount of swap space that is currently unused

memory_swap_total_bytes: Optional[float]

Total amount of swap space available

memory_total_bytes: Optional[float]

Total usable RAM

memory_vmalloc_chunk_bytes: Optional[float]

Largest contiguous block of vmalloc area which is free

memory_vmalloc_total_bytes: Optional[float]

Total size of vmalloc memory area

memory_vmalloc_used_bytes: Optional[float]

Amount of vmalloc area which is used

memory_writeback_bytes: Optional[float]

Memory which is actively being written back to the disk

memory_writeback_tmp_bytes: Optional[float]

Memory used by FUSE for temporary writeback buffers

memory_z_swap_bytes: Optional[float]

Memory consumed by the zswap backend, compressed

memory_z_swapped_bytes: Optional[float]

Amount of anonymous memory stored in zswap, uncompressed

mounts: Optional[List[ItemMount]]
file_system: str

File system on disk (EXT4, NTFS, etc.)

kind: str

Kind of disk (HDD, SSD, etc.)

mount_point: str

Path where disk is mounted

name: str

Name of the disk mount

available_bytes: Optional[float]

Available disk size (bytes)

is_read_only: Optional[bool]

Determines whether the disk is read-only

is_removable: Optional[bool]

Determines whether the disk is removable

total_bytes: Optional[float]

Total disk size (bytes)

netdevs: Optional[List[ItemNetdev]]
name: str

Name of the network device

recv_bytes: float

Total bytes received

recv_compressed: float

Compressed packets received

recv_drop: float

Packets dropped

recv_errs: float

Bad packets received

recv_fifo: float

FIFO overruns

recv_frame: float

Frame alignment errors

recv_multicast: float

Multicast packets received

recv_packets: float

Total packets received

sent_bytes: float

Total bytes transmitted

sent_carrier: float

Number of packets not sent due to carrier errors

sent_colls: float

Number of collisions

sent_compressed: float

Number of compressed packets transmitted

sent_drop: float

Number of packets dropped during transmission

sent_errs: float

Number of transmission errors

sent_fifo: float

FIFO overruns

sent_packets: float

Total packets transmitted

snmp_icmp_in_addr_mask_reps: Optional[float]

Number of ICMP Address Mask Reply messages received

snmp_icmp_in_addr_masks: Optional[float]

Number of ICMP Address Mask Request messages received

snmp_icmp_in_csum_errors: Optional[float]

Number of ICMP messages received with bad checksums

snmp_icmp_in_dest_unreachs: Optional[float]

Number of ICMP Destination Unreachable messages received

snmp_icmp_in_echo_reps: Optional[float]

Number of ICMP Echo Reply messages received

snmp_icmp_in_echos: Optional[float]

Number of ICMP Echo (request) messages received

snmp_icmp_in_errors: Optional[float]

Number of ICMP messages received with ICMP-specific errors

snmp_icmp_in_msgs: Optional[float]

Number of ICMP messages received

snmp_icmp_in_parm_probs: Optional[float]

Number of ICMP Parameter Problem messages received

snmp_icmp_in_redirects: Optional[float]

Number of ICMP Redirect messages received

snmp_icmp_in_src_quenchs: Optional[float]

Number of ICMP Source Quench messages received

snmp_icmp_in_time_excds: Optional[float]

Number of ICMP Time Exceeded messages received

snmp_icmp_in_timestamp_reps: Optional[float]

Number of ICMP Address Mask Request messages received

snmp_icmp_in_timestamps: Optional[float]

Number of ICMP Timestamp (request) messages received

snmp_icmp_out_addr_mask_reps: Optional[float]

Number of ICMP Address Mask Reply messages sent

snmp_icmp_out_addr_masks: Optional[float]

Number of ICMP Address Mask Request messages sent

snmp_icmp_out_dest_unreachs: Optional[float]

Number of ICMP Destination Unreachable messages sent

snmp_icmp_out_echo_reps: Optional[float]

Number of ICMP Echo Reply messages sent

snmp_icmp_out_echos: Optional[float]

Number of ICMP Echo (request) messages sent

snmp_icmp_out_errors: Optional[float]

Number of ICMP messages which this entity did not send due to ICMP-specific errors

snmp_icmp_out_msgs: Optional[float]

Number of ICMP messages attempted to send

snmp_icmp_out_parm_probs: Optional[float]

Number of ICMP Parameter Problem messages sent

snmp_icmp_out_redirects: Optional[float]

Number of ICMP Redirect messages sent

snmp_icmp_out_src_quenchs: Optional[float]

Number of ICMP Source Quench messages sent

snmp_icmp_out_time_excds: Optional[float]

Number of ICMP Time Exceeded messages sent

snmp_icmp_out_timestamp_reps: Optional[float]

Number of ICMP Timestamp Reply messages sent

snmp_icmp_out_timestamps: Optional[float]

Number of ICMP Timestamp (request) messages sent

snmp_ip_default_ttl: Optional[float]

Default value of the Time-To-Live field of the IP header

snmp_ip_forw_datagrams: Optional[float]

Number of datagrams forwarded to their final destination

snmp_ip_forwarding_enabled: Optional[bool]

Set when acting as an IP gateway

snmp_ip_frag_creates: Optional[float]

Number of datagrams generated by fragmentation

snmp_ip_frag_fails: Optional[float]

Number of datagrams discarded because fragmentation failed

snmp_ip_frag_oks: Optional[float]

Number of datagrams successfully fragmented

snmp_ip_in_addr_errors: Optional[float]

Number of input datagrams discarded due to errors in the IP address

snmp_ip_in_delivers: Optional[float]

Number of input datagrams successfully delivered to IP user-protocols

snmp_ip_in_discards: Optional[float]

Number of input datagrams otherwise discarded

snmp_ip_in_hdr_errors: Optional[float]

Number of input datagrams discarded due to errors in the IP header

snmp_ip_in_receives: Optional[float]

Number of input datagrams received from interfaces

snmp_ip_in_unknown_protos: Optional[float]

Number of input datagrams discarded due unknown or unsupported protocol

snmp_ip_out_discards: Optional[float]

Number of output datagrams otherwise discarded

snmp_ip_out_no_routes: Optional[float]

Number of output datagrams discarded because no route matched

snmp_ip_out_requests: Optional[float]

Number of datagrams supplied for transmission

snmp_ip_reasm_fails: Optional[float]

Number of failures detected by the reassembly algorithm

snmp_ip_reasm_oks: Optional[float]

Number of datagrams successfully reassembled

snmp_ip_reasm_reqds: Optional[float]

Number of fragments received which needed to be reassembled

snmp_ip_reasm_timeout: Optional[float]

Number of seconds fragments are held while awaiting reassembly

snmp_tcp_active_opens: Optional[float]

Number of times TCP transitions to SYN-SENT from CLOSED

snmp_tcp_attempt_fails: Optional[float]

Number of times TCP transitions to CLOSED from SYN-SENT or SYN-RCVD, plus transitions to LISTEN from SYN-RCVD

snmp_tcp_curr_estab: Optional[float]

Number of TCP connections in ESTABLISHED or CLOSE-WAIT

snmp_tcp_estab_resets: Optional[float]

Number of times TCP transitions to CLOSED from ESTABLISHED or CLOSE-WAIT

snmp_tcp_in_csum_errors: Optional[float]

Number of TCP segments received with checksum errors

snmp_tcp_in_errs: Optional[float]

Number of TCP segments received in error

snmp_tcp_in_segs: Optional[float]

Number of TCP segments received

snmp_tcp_max_conn: Optional[float]

Limit on the total number of TCP connections

snmp_tcp_out_rsts: Optional[float]

Number of TCP segments sent with RST flag

snmp_tcp_out_segs: Optional[float]

Number of TCP segments sent

snmp_tcp_passive_opens: Optional[float]

Number of times TCP transitions to SYN-RCVD from LISTEN

snmp_tcp_retrans_segs: Optional[float]

Number of TCP segments retransmitted

snmp_tcp_rto_max: Optional[float]

Maximum value permitted by a TCP implementation for the retransmission timeout (milliseconds)

snmp_tcp_rto_min: Optional[float]

Minimum value permitted by a TCP implementation for the retransmission timeout (milliseconds)

snmp_udp_in_datagrams: Optional[float]

Number of UDP datagrams delivered to UDP applications

snmp_udp_in_errors: Optional[float]

Number of UDP datagrams failed to be delivered for reasons other than lack of application at the destination port

snmp_udp_no_ports: Optional[float]

Number of UDP datagrams received for which there was not application at the destination port

snmp_udp_out_datagrams: Optional[float]

Number of UDP datagrams sent

system_boot_time_s: Optional[float]

Boottime of the system (seconds since the Unix epoch)

thermals: Optional[List[ItemThermal]]
label: str

Sensor identifier for the component

critical_celcius: Optional[float]

Critical failure temperature of the component (degrees Celsius)

current_celcius: Optional[float]

Current temperature of the component (degrees Celsius)

max_celcius: Optional[float]

Maximum temperature of the component (degrees Celsius)

tunnels: Optional[List[ItemTunnel]]
health_state: str

Name of tunnel health state (unknown, healthy, degraded, down)

health_value: float

Numeric value associated with tunnel state (0 = unknown, 1 = healthy, 2 = degraded, 3 = down)

interface_name: str

The tunnel interface name (i.e. xfrm1, xfrm3.99, etc.)

tunnel_id: str

Tunnel identifier

probed_mtu: Optional[float]

MTU as measured between the two ends of the tunnel

recent_healthy_pings: Optional[float]

Number of recent healthy pings for this tunnel

recent_unhealthy_pings: Optional[float]

Number of recent unhealthy pings for this tunnel

uptime_idle_ms: Optional[float]

Sum of how much time each core has spent idle

uptime_total_ms: Optional[float]

Uptime of the system, including time spent in suspend