Connectors

List Connectors

client.magicTransit.connectors.list(, ?): SinglePage<ConnectorListResponse { id, activated, interrupt_window_days_of_week, 10 more } >

GET/accounts/{account_id}/magic/connectors

Fetch Connector

client.magicTransit.connectors.get(, , ?): ConnectorGetResponse { id, activated, interrupt_window_days_of_week, 10 more }

GET/accounts/{account_id}/magic/connectors/{connector_id}

Add a connector to your account

client.magicTransit.connectors.create(, ?): ConnectorCreateResponse { id, activated, interrupt_window_days_of_week, 10 more }

POST/accounts/{account_id}/magic/connectors

Replace Connector or Re-provision License Key

client.magicTransit.connectors.update(, , ?): ConnectorUpdateResponse { id, activated, interrupt_window_days_of_week, 10 more }

PUT/accounts/{account_id}/magic/connectors/{connector_id}

Edit Connector to update specific properties or Re-provision License Key

client.magicTransit.connectors.edit(, , ?): ConnectorEditResponse { id, activated, interrupt_window_days_of_week, 10 more }

PATCH/accounts/{account_id}/magic/connectors/{connector_id}

Remove a connector from your account

client.magicTransit.connectors.delete(, , ?): ConnectorDeleteResponse { id, activated, interrupt_window_days_of_week, 10 more }

DELETE/accounts/{account_id}/magic/connectors/{connector_id}

ModelsExpand Collapse

ConnectorListResponse { id, activated, interrupt_window_days_of_week, 10 more }

id: string

activated: boolean

interrupt_window_days_of_week: Array<"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: number

maximum24

minimum1

interrupt_window_embargo_dates: Array<string>

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

interrupt_window_hour_of_day: number

last_updated: string

notes: string

timezone: string

device?: Device { id, serial_number }

id: string

serial_number?: string

last_heartbeat?: string

last_seen_version?: string

license_key?: string

ConnectorGetResponse { id, activated, interrupt_window_days_of_week, 10 more }

id: string

activated: boolean

interrupt_window_days_of_week: Array<"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: number

maximum24

minimum1

interrupt_window_embargo_dates: Array<string>

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

interrupt_window_hour_of_day: number

last_updated: string

notes: string

timezone: string

device?: Device { id, serial_number }

id: string

serial_number?: string

last_heartbeat?: string

last_seen_version?: string

license_key?: string

ConnectorCreateResponse { id, activated, interrupt_window_days_of_week, 10 more }

id: string

activated: boolean

interrupt_window_days_of_week: Array<"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: number

maximum24

minimum1

interrupt_window_embargo_dates: Array<string>

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

interrupt_window_hour_of_day: number

last_updated: string

notes: string

timezone: string

device?: Device { id, serial_number }

id: string

serial_number?: string

last_heartbeat?: string

last_seen_version?: string

license_key?: string

ConnectorUpdateResponse { id, activated, interrupt_window_days_of_week, 10 more }

id: string

activated: boolean

interrupt_window_days_of_week: Array<"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: number

maximum24

minimum1

interrupt_window_embargo_dates: Array<string>

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

interrupt_window_hour_of_day: number

last_updated: string

notes: string

timezone: string

device?: Device { id, serial_number }

id: string

serial_number?: string

last_heartbeat?: string

last_seen_version?: string

license_key?: string

ConnectorEditResponse { id, activated, interrupt_window_days_of_week, 10 more }

id: string

activated: boolean

interrupt_window_days_of_week: Array<"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: number

maximum24

minimum1

interrupt_window_embargo_dates: Array<string>

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

interrupt_window_hour_of_day: number

last_updated: string

notes: string

timezone: string

device?: Device { id, serial_number }

id: string

serial_number?: string

last_heartbeat?: string

last_seen_version?: string

license_key?: string

ConnectorDeleteResponse { id, activated, interrupt_window_days_of_week, 10 more }

id: string

activated: boolean

interrupt_window_days_of_week: Array<"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: number

maximum24

minimum1

interrupt_window_embargo_dates: Array<string>

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

interrupt_window_hour_of_day: number

last_updated: string

notes: string

timezone: string

device?: Device { id, serial_number }

id: string

serial_number?: string

last_heartbeat?: string

last_seen_version?: string

license_key?: string

ConnectorsEvents

List Events

client.magicTransit.connectors.events.list(, , ?): EventListResponse { count, items, cursor }

GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/events

Get Event

client.magicTransit.connectors.events.get(, , , , ?): EventGetResponse { e, n, t, v }

GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/events/{event_t}.{event_n}

ModelsExpand Collapse

EventListResponse { count, items, cursor }

items: Array<Item>

a: number

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

k: string

Kind

n: number

Sequence number, used to order events with the same timestamp

t: number

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

cursor?: string

EventGetResponse { e, n, t, v }

Recorded Event

e: Init { k } | Leave { k } | StartAttestation { k } | 13 more

One of the following:

Init { k }

k: "Init"

Initialized process

Leave { k }

k: "Leave"

Stopped process

StartAttestation { k }

k: "StartAttestation"

Started attestation

FinishAttestationSuccess { k }

k: "FinishAttestationSuccess"

Finished attestation

FinishAttestationFailure { k }

k: "FinishAttestationFailure"

Failed attestation

StartRotateCryptKey { k }

k: "StartRotateCryptKey"

Started crypt key rotation

FinishRotateCryptKeySuccess { k }

k: "FinishRotateCryptKeySuccess"

Finished crypt key rotation

FinishRotateCryptKeyFailure { k }

k: "FinishRotateCryptKeyFailure"

Failed crypt key rotation

StartRotatePki { k }

k: "StartRotatePki"

Started PKI rotation

FinishRotatePkiSuccess { k }

k: "FinishRotatePkiSuccess"

Finished PKI rotation

FinishRotatePkiFailure { k }

k: "FinishRotatePkiFailure"

Failed PKI rotation

StartUpgrade { k, url }

k: "StartUpgrade"

Started upgrade

url: string

Location of upgrade bundle

FinishUpgradeSuccess { k }

k: "FinishUpgradeSuccess"

Finished upgrade

FinishUpgradeFailure { k }

k: "FinishUpgradeFailure"

Failed upgrade

Reconcile { k }

k: "Reconcile"

Reconciled

ConfigureCloudflaredTunnel { k }

k: "ConfigureCloudflaredTunnel"

Configured Cloudflared tunnel

n: number

Sequence number, used to order events with the same timestamp

t: number

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

v?: string

Version

ConnectorsEventsLatest

Get latest Events

client.magicTransit.connectors.events.latest.list(, , ?): LatestListResponse { count, items }

GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/events/latest

ModelsExpand Collapse

LatestListResponse { count, items }

items: Array<Item>

e: Init { k } | Leave { k } | StartAttestation { k } | 13 more

One of the following:

Init { k }

k: "Init"

Initialized process

Leave { k }

k: "Leave"

Stopped process

StartAttestation { k }

k: "StartAttestation"

Started attestation

FinishAttestationSuccess { k }

k: "FinishAttestationSuccess"

Finished attestation

FinishAttestationFailure { k }

k: "FinishAttestationFailure"

Failed attestation

StartRotateCryptKey { k }

k: "StartRotateCryptKey"

Started crypt key rotation

FinishRotateCryptKeySuccess { k }

k: "FinishRotateCryptKeySuccess"

Finished crypt key rotation

FinishRotateCryptKeyFailure { k }

k: "FinishRotateCryptKeyFailure"

Failed crypt key rotation

StartRotatePki { k }

k: "StartRotatePki"

Started PKI rotation

FinishRotatePkiSuccess { k }

k: "FinishRotatePkiSuccess"

Finished PKI rotation

FinishRotatePkiFailure { k }

k: "FinishRotatePkiFailure"

Failed PKI rotation

StartUpgrade { k, url }

k: "StartUpgrade"

Started upgrade

url: string

Location of upgrade bundle

FinishUpgradeSuccess { k }

k: "FinishUpgradeSuccess"

Finished upgrade

FinishUpgradeFailure { k }

k: "FinishUpgradeFailure"

Failed upgrade

Reconcile { k }

k: "Reconcile"

Reconciled

ConfigureCloudflaredTunnel { k }

k: "ConfigureCloudflaredTunnel"

Configured Cloudflared tunnel

n: number

Sequence number, used to order events with the same timestamp

t: number

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

v?: string

Version

ConnectorsSnapshots

List Snapshots

client.magicTransit.connectors.snapshots.list(, , ?): SnapshotListResponse { count, items, cursor }

GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/snapshots

Get Snapshot

client.magicTransit.connectors.snapshots.get(, , , ?): SnapshotGetResponse { count_reclaim_failures, count_reclaimed_paths, count_record_failed, 169 more }

GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/snapshots/{snapshot_t}

ModelsExpand Collapse

SnapshotListResponse { count, items, cursor }

items: Array<Item>

a: number

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

t: number

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

cursor?: string

SnapshotGetResponse { count_reclaim_failures, count_reclaimed_paths, count_record_failed, 169 more }

Snapshot

count_reclaim_failures: number

Count of failures to reclaim space

count_reclaimed_paths: number

Count of reclaimed paths

count_record_failed: number

Count of failed snapshot recordings

count_transmit_failures: number

Count of failed snapshot transmissions

t: number

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

v: string

Version

bonds?: Array<Bond>

Name of the network interface

status: string

Current status of the network interface

cpu_count?: number

Count of processors/cores

cpu_pressure_10s?: number

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

cpu_pressure_300s?: number

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

cpu_pressure_60s?: number

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

cpu_pressure_total_us?: number

Total stall time (microseconds)

cpu_time_guest_ms?: number

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

cpu_time_guest_nice_ms?: number

Time spent running a niced guest (milliseconds)

cpu_time_idle_ms?: number

Time spent in idle state (milliseconds)

cpu_time_iowait_ms?: number

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

cpu_time_irq_ms?: number

Time spent servicing interrupts (milliseconds)

cpu_time_nice_ms?: number

Time spent in low-priority user mode (milliseconds)

cpu_time_softirq_ms?: number

Time spent servicing softirqs (milliseconds)

cpu_time_steal_ms?: number

Time stolen (milliseconds)

cpu_time_system_ms?: number

Time spent in system mode (milliseconds)

cpu_time_user_ms?: number

Time spent in user mode (milliseconds)

delta?: number

Number of network operations applied during state transition

dhcp_leases?: Array<DHCPLease>

client_id: string

Client ID of the device the IP Address was leased to

expiry_time: number

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

hostname: string

Hostname of the device the IP Address was leased to

interface_name: string

Name of the network interface

ip_address: string

IP Address that was leased

mac_address: string

MAC Address of the device the IP Address was leased to

disks?: Array<Disk>

in_progress: number

I/Os currently in progress

major: number

Device major number

merged: number

Reads merged

minor: number

Device minor number

Device name

reads: number

Reads completed successfully

sectors_read: number

Sectors read successfully

sectors_written: number

Sectors written successfully

time_in_progress_ms: number

Time spent doing I/Os (milliseconds)

time_reading_ms: number

Time spent reading (milliseconds)

time_writing_ms: number

Time spent writing (milliseconds)

weighted_time_in_progress_ms: number

Weighted time spent doing I/Os (milliseconds)

writes: number

Writes completed

writes_merged: number

Writes merged

discards?: number

Discards completed successfully

discards_merged?: number

Discards merged

flushes?: number

Flushes completed successfully

sectors_discarded?: number

Sectors discarded

time_discarding_ms?: number

Time spent discarding (milliseconds)

time_flushing_ms?: number

Time spent flushing (milliseconds)

epsilon?: number

Simulated number of network operations applied during state transition

ha_state?: string

Name of high availability state

ha_value?: number

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

interfaces?: Array<Interface>

Name of the network interface

operstate: string

UP/DOWN state of the network interface

ip_addresses?: Array<IPAddress>

interface_name: string

Name of the network interface

ip_address: string

IP address of the network interface

speed?: number

Speed of the network interface (bits per second)

io_pressure_full_10s?: number

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

io_pressure_full_300s?: number

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

io_pressure_full_60s?: number

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

io_pressure_full_total_us?: number

Total stall time (microseconds)

io_pressure_some_10s?: number

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

io_pressure_some_300s?: number

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

io_pressure_some_60s?: number

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

io_pressure_some_total_us?: number

Total stall time (microseconds)

kernel_btime?: number

Boot time (seconds since Unix epoch)

kernel_ctxt?: number

Number of context switches that the system underwent

kernel_processes?: number

Number of forks since boot

kernel_processes_blocked?: number

Number of processes blocked waiting for I/O

kernel_processes_running?: number

Number of processes in runnable state

load_average_15m?: number

The fifteen-minute load average

load_average_1m?: number

The one-minute load average

load_average_5m?: number

The five-minute load average

load_average_cur?: number

Number of currently runnable kernel scheduling entities

load_average_max?: number

Number of kernel scheduling entities that currently exist on the system

memory_active_bytes?: number

Memory that has been used more recently

memory_anon_hugepages_bytes?: number

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

memory_anon_pages_bytes?: number

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

memory_available_bytes?: number

Estimate of how much memory is available for starting new applications

memory_bounce_bytes?: number

Memory used for block device bounce buffers

memory_buffers_bytes?: number

Relatively temporary storage for raw disk blocks

memory_cached_bytes?: number

In-memory cache for files read from the disk

memory_cma_free_bytes?: number

Free CMA (Contiguous Memory Allocator) pages

memory_cma_total_bytes?: number

Total CMA (Contiguous Memory Allocator) pages

memory_commit_limit_bytes?: number

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

memory_committed_as_bytes?: number

Amount of memory presently allocated on the system

memory_dirty_bytes?: number

Memory which is waiting to get written back to the disk

memory_free_bytes?: number

The sum of LowFree and HighFree

memory_high_free_bytes?: number

Amount of free highmem

memory_high_total_bytes?: number

Total amount of highmem

memory_hugepages_free?: number

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

memory_hugepages_rsvd?: number

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

memory_hugepages_surp?: number

Number of huge pages in the pool above the threshold

memory_hugepages_total?: number

The size of the pool of huge pages

memory_hugepagesize_bytes?: number

The size of huge pages

memory_inactive_bytes?: number

Memory which has been less recently used

memory_k_reclaimable_bytes?: number

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

memory_kernel_stack_bytes?: number

Amount of memory allocated to kernel stacks

memory_low_free_bytes?: number

Amount of free lowmem

memory_low_total_bytes?: number

Total amount of lowmem

memory_mapped_bytes?: number

Files which have been mapped into memory

memory_page_tables_bytes?: number

Amount of memory dedicated to the lowest level of page tables

memory_per_cpu_bytes?: number

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

memory_pressure_full_10s?: number

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

memory_pressure_full_300s?: number

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

memory_pressure_full_60s?: number

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

memory_pressure_full_total_us?: number

Total stall time (microseconds)

memory_pressure_some_10s?: number

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

memory_pressure_some_300s?: number

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

memory_pressure_some_60s?: number

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

memory_pressure_some_total_us?: number

Total stall time (microseconds)

memory_s_reclaimable_bytes?: number

Part of slab that can be reclaimed on memory pressure

memory_s_unreclaim_bytes?: number

Part of slab that cannot be reclaimed on memory pressure

memory_secondary_page_tables_bytes?: number

Amount of memory dedicated to the lowest level of page tables

memory_shmem_bytes?: number

Amount of memory consumed by tmpfs

memory_shmem_hugepages_bytes?: number

Memory used by shmem and tmpfs, allocated with huge pages

memory_shmem_pmd_mapped_bytes?: number

Shared memory mapped into user space with huge pages

memory_slab_bytes?: number

In-kernel data structures cache

memory_swap_cached_bytes?: number

Memory swapped out and back in while still in swap file

memory_swap_free_bytes?: number

Amount of swap space that is currently unused

memory_swap_total_bytes?: number

Total amount of swap space available

memory_total_bytes?: number

Total usable RAM

memory_vmalloc_chunk_bytes?: number

Largest contiguous block of vmalloc area which is free

memory_vmalloc_total_bytes?: number

Total size of vmalloc memory area

memory_vmalloc_used_bytes?: number

Amount of vmalloc area which is used

memory_writeback_bytes?: number

Memory which is actively being written back to the disk

memory_writeback_tmp_bytes?: number

Memory used by FUSE for temporary writeback buffers

memory_z_swap_bytes?: number

Memory consumed by the zswap backend, compressed

memory_z_swapped_bytes?: number

Amount of anonymous memory stored in zswap, uncompressed

mounts?: Array<Mount>

file_system: string

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

kind: string

Kind of disk (HDD, SSD, etc.)

mount_point: string

Path where disk is mounted

Name of the disk mount

available_bytes?: number

Available disk size (bytes)

is_read_only?: boolean

Determines whether the disk is read-only

is_removable?: boolean

Determines whether the disk is removable

total_bytes?: number

Total disk size (bytes)

netdevs?: Array<Netdev>

Name of the network device

recv_bytes: number

Total bytes received

recv_compressed: number

Compressed packets received

recv_drop: number

Packets dropped

recv_errs: number

Bad packets received

recv_fifo: number

FIFO overruns

recv_frame: number

Frame alignment errors

recv_multicast: number

Multicast packets received

recv_packets: number

Total packets received

sent_bytes: number

Total bytes transmitted

sent_carrier: number

Number of packets not sent due to carrier errors

sent_colls: number

Number of collisions

sent_compressed: number

Number of compressed packets transmitted

sent_drop: number

Number of packets dropped during transmission

sent_errs: number

Number of transmission errors

sent_fifo: number

FIFO overruns

sent_packets: number

Total packets transmitted

snmp_icmp_in_addr_mask_reps?: number

Number of ICMP Address Mask Reply messages received

snmp_icmp_in_addr_masks?: number

Number of ICMP Address Mask Request messages received

snmp_icmp_in_csum_errors?: number

Number of ICMP messages received with bad checksums

snmp_icmp_in_dest_unreachs?: number

Number of ICMP Destination Unreachable messages received

snmp_icmp_in_echo_reps?: number

Number of ICMP Echo Reply messages received

snmp_icmp_in_echos?: number

Number of ICMP Echo (request) messages received

snmp_icmp_in_errors?: number

Number of ICMP messages received with ICMP-specific errors

snmp_icmp_in_msgs?: number

Number of ICMP messages received

snmp_icmp_in_parm_probs?: number

Number of ICMP Parameter Problem messages received

snmp_icmp_in_redirects?: number

Number of ICMP Redirect messages received

snmp_icmp_in_src_quenchs?: number

Number of ICMP Source Quench messages received

snmp_icmp_in_time_excds?: number

Number of ICMP Time Exceeded messages received

snmp_icmp_in_timestamp_reps?: number

Number of ICMP Address Mask Request messages received

snmp_icmp_in_timestamps?: number

Number of ICMP Timestamp (request) messages received

snmp_icmp_out_addr_mask_reps?: number

Number of ICMP Address Mask Reply messages sent

snmp_icmp_out_addr_masks?: number

Number of ICMP Address Mask Request messages sent

snmp_icmp_out_dest_unreachs?: number

Number of ICMP Destination Unreachable messages sent

snmp_icmp_out_echo_reps?: number

Number of ICMP Echo Reply messages sent

snmp_icmp_out_echos?: number

Number of ICMP Echo (request) messages sent

snmp_icmp_out_errors?: number

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

snmp_icmp_out_msgs?: number

Number of ICMP messages attempted to send

snmp_icmp_out_parm_probs?: number

Number of ICMP Parameter Problem messages sent

snmp_icmp_out_redirects?: number

Number of ICMP Redirect messages sent

snmp_icmp_out_src_quenchs?: number

Number of ICMP Source Quench messages sent

snmp_icmp_out_time_excds?: number

Number of ICMP Time Exceeded messages sent

snmp_icmp_out_timestamp_reps?: number

Number of ICMP Timestamp Reply messages sent

snmp_icmp_out_timestamps?: number

Number of ICMP Timestamp (request) messages sent

snmp_ip_default_ttl?: number

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

snmp_ip_forw_datagrams?: number

Number of datagrams forwarded to their final destination

snmp_ip_forwarding_enabled?: boolean

Set when acting as an IP gateway

snmp_ip_frag_creates?: number

Number of datagrams generated by fragmentation

snmp_ip_frag_fails?: number

Number of datagrams discarded because fragmentation failed

snmp_ip_frag_oks?: number

Number of datagrams successfully fragmented

snmp_ip_in_addr_errors?: number

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

snmp_ip_in_delivers?: number

Number of input datagrams successfully delivered to IP user-protocols

snmp_ip_in_discards?: number

Number of input datagrams otherwise discarded

snmp_ip_in_hdr_errors?: number

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

snmp_ip_in_receives?: number

Number of input datagrams received from interfaces

snmp_ip_in_unknown_protos?: number

Number of input datagrams discarded due unknown or unsupported protocol

snmp_ip_out_discards?: number

Number of output datagrams otherwise discarded

snmp_ip_out_no_routes?: number

Number of output datagrams discarded because no route matched

snmp_ip_out_requests?: number

Number of datagrams supplied for transmission

snmp_ip_reasm_fails?: number

Number of failures detected by the reassembly algorithm

snmp_ip_reasm_oks?: number

Number of datagrams successfully reassembled

snmp_ip_reasm_reqds?: number

Number of fragments received which needed to be reassembled

snmp_ip_reasm_timeout?: number

Number of seconds fragments are held while awaiting reassembly

snmp_tcp_active_opens?: number

Number of times TCP transitions to SYN-SENT from CLOSED

snmp_tcp_attempt_fails?: number

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

snmp_tcp_curr_estab?: number

Number of TCP connections in ESTABLISHED or CLOSE-WAIT

snmp_tcp_estab_resets?: number

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

snmp_tcp_in_csum_errors?: number

Number of TCP segments received with checksum errors

snmp_tcp_in_errs?: number

Number of TCP segments received in error

snmp_tcp_in_segs?: number

Number of TCP segments received

snmp_tcp_max_conn?: number

Limit on the total number of TCP connections

snmp_tcp_out_rsts?: number

Number of TCP segments sent with RST flag

snmp_tcp_out_segs?: number

Number of TCP segments sent

snmp_tcp_passive_opens?: number

Number of times TCP transitions to SYN-RCVD from LISTEN

snmp_tcp_retrans_segs?: number

Number of TCP segments retransmitted

snmp_tcp_rto_max?: number

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

snmp_tcp_rto_min?: number

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

snmp_udp_in_datagrams?: number

Number of UDP datagrams delivered to UDP applications

snmp_udp_in_errors?: number

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

snmp_udp_no_ports?: number

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

snmp_udp_out_datagrams?: number

Number of UDP datagrams sent

system_boot_time_s?: number

Boottime of the system (seconds since the Unix epoch)

thermals?: Array<Thermal>

label: string

Sensor identifier for the component

critical_celcius?: number

Critical failure temperature of the component (degrees Celsius)

current_celcius?: number

Current temperature of the component (degrees Celsius)

max_celcius?: number

Maximum temperature of the component (degrees Celsius)

tunnels?: Array<Tunnel>

health_state: string

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

health_value: number

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

interface_name: string

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

tunnel_id: string

Tunnel identifier

probed_mtu?: number

MTU as measured between the two ends of the tunnel

recent_healthy_pings?: number

Number of recent healthy pings for this tunnel

recent_unhealthy_pings?: number

Number of recent unhealthy pings for this tunnel

uptime_idle_ms?: number

Sum of how much time each core has spent idle

uptime_total_ms?: number

Uptime of the system, including time spent in suspend

ConnectorsSnapshotsLatest

Get latest Snapshots

client.magicTransit.connectors.snapshots.latest.list(, , ?): LatestListResponse { count, items }

GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/snapshots/latest

ModelsExpand Collapse

LatestListResponse { count, items }

items: Array<Item>

count_reclaim_failures: number

Count of failures to reclaim space

count_reclaimed_paths: number

Count of reclaimed paths

count_record_failed: number

Count of failed snapshot recordings

count_transmit_failures: number

Count of failed snapshot transmissions

t: number

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

v: string

Version

bonds?: Array<Bond>

Name of the network interface

status: string

Current status of the network interface

cpu_count?: number

Count of processors/cores

cpu_pressure_10s?: number

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

cpu_pressure_300s?: number

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

cpu_pressure_60s?: number

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

cpu_pressure_total_us?: number

Total stall time (microseconds)

cpu_time_guest_ms?: number

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

cpu_time_guest_nice_ms?: number

Time spent running a niced guest (milliseconds)

cpu_time_idle_ms?: number

Time spent in idle state (milliseconds)

cpu_time_iowait_ms?: number

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

cpu_time_irq_ms?: number

Time spent servicing interrupts (milliseconds)

cpu_time_nice_ms?: number

Time spent in low-priority user mode (milliseconds)

cpu_time_softirq_ms?: number

Time spent servicing softirqs (milliseconds)

cpu_time_steal_ms?: number

Time stolen (milliseconds)

cpu_time_system_ms?: number

Time spent in system mode (milliseconds)

cpu_time_user_ms?: number

Time spent in user mode (milliseconds)

delta?: number

Number of network operations applied during state transition

dhcp_leases?: Array<DHCPLease>

client_id: string

Client ID of the device the IP Address was leased to

expiry_time: number

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

hostname: string

Hostname of the device the IP Address was leased to

interface_name: string

Name of the network interface

ip_address: string

IP Address that was leased

mac_address: string

MAC Address of the device the IP Address was leased to

disks?: Array<Disk>

in_progress: number

I/Os currently in progress

major: number

Device major number

merged: number

Reads merged

minor: number

Device minor number

Device name

reads: number

Reads completed successfully

sectors_read: number

Sectors read successfully

sectors_written: number

Sectors written successfully

time_in_progress_ms: number

Time spent doing I/Os (milliseconds)

time_reading_ms: number

Time spent reading (milliseconds)

time_writing_ms: number

Time spent writing (milliseconds)

weighted_time_in_progress_ms: number

Weighted time spent doing I/Os (milliseconds)

writes: number

Writes completed

writes_merged: number

Writes merged

discards?: number

Discards completed successfully

discards_merged?: number

Discards merged

flushes?: number

Flushes completed successfully

sectors_discarded?: number

Sectors discarded

time_discarding_ms?: number

Time spent discarding (milliseconds)

time_flushing_ms?: number

Time spent flushing (milliseconds)

epsilon?: number

Simulated number of network operations applied during state transition

ha_state?: string

Name of high availability state

ha_value?: number

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

interfaces?: Array<Interface>

Name of the network interface

operstate: string

UP/DOWN state of the network interface

ip_addresses?: Array<IPAddress>

interface_name: string

Name of the network interface

ip_address: string

IP address of the network interface

speed?: number

Speed of the network interface (bits per second)

io_pressure_full_10s?: number

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

io_pressure_full_300s?: number

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

io_pressure_full_60s?: number

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

io_pressure_full_total_us?: number

Total stall time (microseconds)

io_pressure_some_10s?: number

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

io_pressure_some_300s?: number

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

io_pressure_some_60s?: number

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

io_pressure_some_total_us?: number

Total stall time (microseconds)

kernel_btime?: number

Boot time (seconds since Unix epoch)

kernel_ctxt?: number

Number of context switches that the system underwent

kernel_processes?: number

Number of forks since boot

kernel_processes_blocked?: number

Number of processes blocked waiting for I/O

kernel_processes_running?: number

Number of processes in runnable state

load_average_15m?: number

The fifteen-minute load average

load_average_1m?: number

The one-minute load average

load_average_5m?: number

The five-minute load average

load_average_cur?: number

Number of currently runnable kernel scheduling entities

load_average_max?: number

Number of kernel scheduling entities that currently exist on the system

memory_active_bytes?: number

Memory that has been used more recently

memory_anon_hugepages_bytes?: number

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

memory_anon_pages_bytes?: number

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

memory_available_bytes?: number

Estimate of how much memory is available for starting new applications

memory_bounce_bytes?: number

Memory used for block device bounce buffers

memory_buffers_bytes?: number

Relatively temporary storage for raw disk blocks

memory_cached_bytes?: number

In-memory cache for files read from the disk

memory_cma_free_bytes?: number

Free CMA (Contiguous Memory Allocator) pages

memory_cma_total_bytes?: number

Total CMA (Contiguous Memory Allocator) pages

memory_commit_limit_bytes?: number

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

memory_committed_as_bytes?: number

Amount of memory presently allocated on the system

memory_dirty_bytes?: number

Memory which is waiting to get written back to the disk

memory_free_bytes?: number

The sum of LowFree and HighFree

memory_high_free_bytes?: number

Amount of free highmem

memory_high_total_bytes?: number

Total amount of highmem

memory_hugepages_free?: number

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

memory_hugepages_rsvd?: number

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

memory_hugepages_surp?: number

Number of huge pages in the pool above the threshold

memory_hugepages_total?: number

The size of the pool of huge pages

memory_hugepagesize_bytes?: number

The size of huge pages

memory_inactive_bytes?: number

Memory which has been less recently used

memory_k_reclaimable_bytes?: number

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

memory_kernel_stack_bytes?: number

Amount of memory allocated to kernel stacks

memory_low_free_bytes?: number

Amount of free lowmem

memory_low_total_bytes?: number

Total amount of lowmem

memory_mapped_bytes?: number

Files which have been mapped into memory

memory_page_tables_bytes?: number

Amount of memory dedicated to the lowest level of page tables

memory_per_cpu_bytes?: number

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

memory_pressure_full_10s?: number

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

memory_pressure_full_300s?: number

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

memory_pressure_full_60s?: number

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

memory_pressure_full_total_us?: number

Total stall time (microseconds)

memory_pressure_some_10s?: number

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

memory_pressure_some_300s?: number

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

memory_pressure_some_60s?: number

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

memory_pressure_some_total_us?: number

Total stall time (microseconds)

memory_s_reclaimable_bytes?: number

Part of slab that can be reclaimed on memory pressure

memory_s_unreclaim_bytes?: number

Part of slab that cannot be reclaimed on memory pressure

memory_secondary_page_tables_bytes?: number

Amount of memory dedicated to the lowest level of page tables

memory_shmem_bytes?: number

Amount of memory consumed by tmpfs

memory_shmem_hugepages_bytes?: number

Memory used by shmem and tmpfs, allocated with huge pages

memory_shmem_pmd_mapped_bytes?: number

Shared memory mapped into user space with huge pages

memory_slab_bytes?: number

In-kernel data structures cache

memory_swap_cached_bytes?: number

Memory swapped out and back in while still in swap file

memory_swap_free_bytes?: number

Amount of swap space that is currently unused

memory_swap_total_bytes?: number

Total amount of swap space available

memory_total_bytes?: number

Total usable RAM

memory_vmalloc_chunk_bytes?: number

Largest contiguous block of vmalloc area which is free

memory_vmalloc_total_bytes?: number

Total size of vmalloc memory area

memory_vmalloc_used_bytes?: number

Amount of vmalloc area which is used

memory_writeback_bytes?: number

Memory which is actively being written back to the disk

memory_writeback_tmp_bytes?: number

Memory used by FUSE for temporary writeback buffers

memory_z_swap_bytes?: number

Memory consumed by the zswap backend, compressed

memory_z_swapped_bytes?: number

Amount of anonymous memory stored in zswap, uncompressed

mounts?: Array<Mount>

file_system: string

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

kind: string

Kind of disk (HDD, SSD, etc.)

mount_point: string

Path where disk is mounted

Name of the disk mount

available_bytes?: number

Available disk size (bytes)

is_read_only?: boolean

Determines whether the disk is read-only

is_removable?: boolean

Determines whether the disk is removable

total_bytes?: number

Total disk size (bytes)

netdevs?: Array<Netdev>

Name of the network device

recv_bytes: number

Total bytes received

recv_compressed: number

Compressed packets received

recv_drop: number

Packets dropped

recv_errs: number

Bad packets received

recv_fifo: number

FIFO overruns

recv_frame: number

Frame alignment errors

recv_multicast: number

Multicast packets received

recv_packets: number

Total packets received

sent_bytes: number

Total bytes transmitted

sent_carrier: number

Number of packets not sent due to carrier errors

sent_colls: number

Number of collisions

sent_compressed: number

Number of compressed packets transmitted

sent_drop: number

Number of packets dropped during transmission

sent_errs: number

Number of transmission errors

sent_fifo: number

FIFO overruns

sent_packets: number

Total packets transmitted

snmp_icmp_in_addr_mask_reps?: number

Number of ICMP Address Mask Reply messages received

snmp_icmp_in_addr_masks?: number

Number of ICMP Address Mask Request messages received

snmp_icmp_in_csum_errors?: number

Number of ICMP messages received with bad checksums

snmp_icmp_in_dest_unreachs?: number

Number of ICMP Destination Unreachable messages received

snmp_icmp_in_echo_reps?: number

Number of ICMP Echo Reply messages received

snmp_icmp_in_echos?: number

Number of ICMP Echo (request) messages received

snmp_icmp_in_errors?: number

Number of ICMP messages received with ICMP-specific errors

snmp_icmp_in_msgs?: number

Number of ICMP messages received

snmp_icmp_in_parm_probs?: number

Number of ICMP Parameter Problem messages received

snmp_icmp_in_redirects?: number

Number of ICMP Redirect messages received

snmp_icmp_in_src_quenchs?: number

Number of ICMP Source Quench messages received

snmp_icmp_in_time_excds?: number

Number of ICMP Time Exceeded messages received

snmp_icmp_in_timestamp_reps?: number

Number of ICMP Address Mask Request messages received

snmp_icmp_in_timestamps?: number

Number of ICMP Timestamp (request) messages received

snmp_icmp_out_addr_mask_reps?: number

Number of ICMP Address Mask Reply messages sent

snmp_icmp_out_addr_masks?: number

Number of ICMP Address Mask Request messages sent

snmp_icmp_out_dest_unreachs?: number

Number of ICMP Destination Unreachable messages sent

snmp_icmp_out_echo_reps?: number

Number of ICMP Echo Reply messages sent

snmp_icmp_out_echos?: number

Number of ICMP Echo (request) messages sent

snmp_icmp_out_errors?: number

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

snmp_icmp_out_msgs?: number

Number of ICMP messages attempted to send

snmp_icmp_out_parm_probs?: number

Number of ICMP Parameter Problem messages sent

snmp_icmp_out_redirects?: number

Number of ICMP Redirect messages sent

snmp_icmp_out_src_quenchs?: number

Number of ICMP Source Quench messages sent

snmp_icmp_out_time_excds?: number

Number of ICMP Time Exceeded messages sent

snmp_icmp_out_timestamp_reps?: number

Number of ICMP Timestamp Reply messages sent

snmp_icmp_out_timestamps?: number

Number of ICMP Timestamp (request) messages sent

snmp_ip_default_ttl?: number

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

snmp_ip_forw_datagrams?: number

Number of datagrams forwarded to their final destination

snmp_ip_forwarding_enabled?: boolean

Set when acting as an IP gateway

snmp_ip_frag_creates?: number

Number of datagrams generated by fragmentation

snmp_ip_frag_fails?: number

Number of datagrams discarded because fragmentation failed

snmp_ip_frag_oks?: number

Number of datagrams successfully fragmented

snmp_ip_in_addr_errors?: number

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

snmp_ip_in_delivers?: number

Number of input datagrams successfully delivered to IP user-protocols

snmp_ip_in_discards?: number

Number of input datagrams otherwise discarded

snmp_ip_in_hdr_errors?: number

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

snmp_ip_in_receives?: number

Number of input datagrams received from interfaces

snmp_ip_in_unknown_protos?: number

Number of input datagrams discarded due unknown or unsupported protocol

snmp_ip_out_discards?: number

Number of output datagrams otherwise discarded

snmp_ip_out_no_routes?: number

Number of output datagrams discarded because no route matched

snmp_ip_out_requests?: number

Number of datagrams supplied for transmission

snmp_ip_reasm_fails?: number

Number of failures detected by the reassembly algorithm

snmp_ip_reasm_oks?: number

Number of datagrams successfully reassembled

snmp_ip_reasm_reqds?: number

Number of fragments received which needed to be reassembled

snmp_ip_reasm_timeout?: number

Number of seconds fragments are held while awaiting reassembly

snmp_tcp_active_opens?: number

Number of times TCP transitions to SYN-SENT from CLOSED

snmp_tcp_attempt_fails?: number

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

snmp_tcp_curr_estab?: number

Number of TCP connections in ESTABLISHED or CLOSE-WAIT

snmp_tcp_estab_resets?: number

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

snmp_tcp_in_csum_errors?: number

Number of TCP segments received with checksum errors

snmp_tcp_in_errs?: number

Number of TCP segments received in error

snmp_tcp_in_segs?: number

Number of TCP segments received

snmp_tcp_max_conn?: number

Limit on the total number of TCP connections

snmp_tcp_out_rsts?: number

Number of TCP segments sent with RST flag

snmp_tcp_out_segs?: number

Number of TCP segments sent

snmp_tcp_passive_opens?: number

Number of times TCP transitions to SYN-RCVD from LISTEN

snmp_tcp_retrans_segs?: number

Number of TCP segments retransmitted

snmp_tcp_rto_max?: number

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

snmp_tcp_rto_min?: number

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

snmp_udp_in_datagrams?: number

Number of UDP datagrams delivered to UDP applications

snmp_udp_in_errors?: number

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

snmp_udp_no_ports?: number

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

snmp_udp_out_datagrams?: number

Number of UDP datagrams sent

system_boot_time_s?: number

Boottime of the system (seconds since the Unix epoch)

thermals?: Array<Thermal>

label: string

Sensor identifier for the component

critical_celcius?: number

Critical failure temperature of the component (degrees Celsius)

current_celcius?: number

Current temperature of the component (degrees Celsius)

max_celcius?: number

Maximum temperature of the component (degrees Celsius)

tunnels?: Array<Tunnel>

health_state: string

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

health_value: number

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

interface_name: string

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

tunnel_id: string

Tunnel identifier

probed_mtu?: number

MTU as measured between the two ends of the tunnel

recent_healthy_pings?: number

Number of recent healthy pings for this tunnel

recent_unhealthy_pings?: number

Number of recent unhealthy pings for this tunnel

uptime_idle_ms?: number

Sum of how much time each core has spent idle

uptime_total_ms?: number

Uptime of the system, including time spent in suspend