Skip to content
Cloudflare API
Start here
API Reference
Magic Transit
Connectors

Events

List Events
client.magicTransit.connectors.events.list(stringconnectorID, EventListParams { account_id, from, to, 3 more } params, RequestOptionsoptions?): EventListResponse { count, items, cursor }
GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/events
Get Event
client.magicTransit.connectors.events.get(numbereventN, EventGetParams { account_id, connector_id, event_t } params, RequestOptionsoptions?): 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 }
count: number
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: E { k }

Event kind plus event-specific payload fields.

Event kinds:

  • Init: Initialized process
  • Leave: Stopped process
  • StartAttestation: Started attestation
  • FinishAttestationSuccess: Finished attestation
  • FinishAttestationFailure: Failed attestation
  • StartRotateCryptKey: Started crypt key rotation
  • FinishRotateCryptKeySuccess: Finished crypt key rotation
  • FinishRotateCryptKeyFailure: Failed crypt key rotation
  • StartRotatePki: Started PKI rotation
  • FinishRotatePkiSuccess: Finished PKI rotation
  • FinishRotatePkiFailure: Failed PKI rotation
  • StartUpgrade: Started upgrade
  • FinishUpgradeSuccess: Finished upgrade
  • FinishUpgradeFailure: Failed upgrade
  • Reconcile: Reconciled
  • ConfigureCloudflaredTunnel: Configured Cloudflared tunnel
  • RekeyInstallBoth: Installed initial inbound and outbound keys
  • RekeyStart: Installed new inbound key, kept old outbound
  • RekeyRestart: Restarted in-progress rekey with newer key material
  • RekeyAdvance: Confirmed traffic on new inbound key, swapped outbound to new
  • RekeyComplete: Deleted old keys
  • RekeyReset: Deleted all keys after receiving an unexpected key
  • HaTransition: Completed HA state transition
  • HaError: Received unexpected HA error
  • HaInit: Initialized HA subsystem
  • HaLeave: Stopped HA subsystem
k: "Init" | "Leave" | "StartAttestation" | 23 more

Event kind

One of the following:
"Init"
"Leave"
"StartAttestation"
"FinishAttestationSuccess"
"FinishAttestationFailure"
"StartRotateCryptKey"
"FinishRotateCryptKeySuccess"
"FinishRotateCryptKeyFailure"
"StartRotatePki"
"FinishRotatePkiSuccess"
"FinishRotatePkiFailure"
"StartUpgrade"
"FinishUpgradeSuccess"
"FinishUpgradeFailure"
"Reconcile"
"ConfigureCloudflaredTunnel"
"RekeyInstallBoth"
"RekeyStart"
"RekeyRestart"
"RekeyAdvance"
"RekeyComplete"
"RekeyReset"
"HaTransition"
"HaError"
"HaInit"
"HaLeave"
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

EventsLatest

Get latest Events
client.magicTransit.connectors.events.latest.list(stringconnectorID, LatestListParams { account_id } params, RequestOptionsoptions?): LatestListResponse { count, items }
GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/events/latest
ModelsExpand Collapse
LatestListResponse { count, items }
count: number
items: Array<Item>
e: E { k }

Event kind plus event-specific payload fields.

Event kinds:

  • Init: Initialized process
  • Leave: Stopped process
  • StartAttestation: Started attestation
  • FinishAttestationSuccess: Finished attestation
  • FinishAttestationFailure: Failed attestation
  • StartRotateCryptKey: Started crypt key rotation
  • FinishRotateCryptKeySuccess: Finished crypt key rotation
  • FinishRotateCryptKeyFailure: Failed crypt key rotation
  • StartRotatePki: Started PKI rotation
  • FinishRotatePkiSuccess: Finished PKI rotation
  • FinishRotatePkiFailure: Failed PKI rotation
  • StartUpgrade: Started upgrade
  • FinishUpgradeSuccess: Finished upgrade
  • FinishUpgradeFailure: Failed upgrade
  • Reconcile: Reconciled
  • ConfigureCloudflaredTunnel: Configured Cloudflared tunnel
  • RekeyInstallBoth: Installed initial inbound and outbound keys
  • RekeyStart: Installed new inbound key, kept old outbound
  • RekeyRestart: Restarted in-progress rekey with newer key material
  • RekeyAdvance: Confirmed traffic on new inbound key, swapped outbound to new
  • RekeyComplete: Deleted old keys
  • RekeyReset: Deleted all keys after receiving an unexpected key
  • HaTransition: Completed HA state transition
  • HaError: Received unexpected HA error
  • HaInit: Initialized HA subsystem
  • HaLeave: Stopped HA subsystem
k: "Init" | "Leave" | "StartAttestation" | 23 more

Event kind

One of the following:
"Init"
"Leave"
"StartAttestation"
"FinishAttestationSuccess"
"FinishAttestationFailure"
"StartRotateCryptKey"
"FinishRotateCryptKeySuccess"
"FinishRotateCryptKeyFailure"
"StartRotatePki"
"FinishRotatePkiSuccess"
"FinishRotatePkiFailure"
"StartUpgrade"
"FinishUpgradeSuccess"
"FinishUpgradeFailure"
"Reconcile"
"ConfigureCloudflaredTunnel"
"RekeyInstallBoth"
"RekeyStart"
"RekeyRestart"
"RekeyAdvance"
"RekeyComplete"
"RekeyReset"
"HaTransition"
"HaError"
"HaInit"
"HaLeave"
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