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.
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.