docs
cairnobs.org Demo Source
Esc

What it watches · 12 of 14

Akamai

Akamai read with a read-only API client: GTM datacenters and liveness, CPS certificates, Property Manager activations, Edge DNS drift and 5xx rates by CP code.

1 min read

obs-beacond reads Akamai itself every five minutes (CPS, Property Manager and Edge DNS every 15), with an API client that has read-only grants. The Akamai page appears once it's set up.

Set it up

In Akamai Control Center, Identity and Access › API clients, make a client with read-only grants for the products below. Save its .edgerc where only obs-beacond can read it (root:obs-beacon, 0640), and:

akamai:
  edgerc_file: /etc/obs-beacon/akamai.edgerc
  # section: default
  # domains: [example.akadns.net]   # GTM domains; default every one the client can read
  # contracts: [ctr_1-ABCDE]        # whose CPS enrollments are read

Every request is a GET, except the traffic report's query, which Akamai's Reporting API takes only as a POST; it changes nothing. A product the client can't read is skipped, and the page says so.

What's read and judged

What Alert
A GTM property has no live datacenter Critical
A server failing GTM's liveness test Warning, on the host with that address
A GTM change propagating for over 30 minutes, or refused Warning
A CPS certificate on production ends within 21 / 7 days (a third / a tenth of a short life) Warning / critical
A CPS change waiting on you (a CSR, a staging check, warnings to acknowledge) Warning
A property's newest activation failed, or pending over an hour Warning
An Edge DNS zone's records changed since last accepted Warning, until accepted on the Akamai page
A CP code's 5xx share of edge hits over 5% / 25%, with at least 20 (the latest 5-minute report) Warning / critical
The API can't be read for 3 polls in a row Warning; the last good reading stays

error_warn_pct, error_critical_pct, error_min and every change the thresholds and the pace. CPS certificates also join the certificate inventory; their alerts stay here. Akamai's status page is shown, never alerted on.