Skip to main content

Who is on call by integration key

Tool: oppex.oncall.whoIsOnCallByServiceKey

Shows who is on call for the service that owns an integration key. It returns the same details as Who is on call for a service. Use it when you have the key from a monitoring tool's configuration but not the service name, for example while checking where an alert rule sends its alerts.

What you provide​

InputRequiredDescription
Integration keyYesThe service's integration key, exactly as shown under Integration Details on the service.

Example prompts​

  • "This New Relic workflow sends to integration key a1b2c3d4-… — who gets paged for it?"
  • "Who is on call for the service whose key is in this config file?"
  • "Check which service and on-call team the key in our Grafana contact point belongs to."

Who can use it​

Anyone, whatever their role.

What you get back​

The service's name and, for each escalation policy and level, the people on call right now, with the schedule, shift end, contact number and contact methods. See What you get back.

Limits and errors​

MessageMeaning
"Service not found for key: <key>"No active service in your connection's workspace has that integration key.
The integration key is a credential

Together with an API key, an integration key lets a tool raise incidents on the service. Share it with the assistant only in a conversation you trust, and do not paste it into public channels.

FAQ

Where do I find a service's integration key?

Open Services, click Integration Details on the service's row, and choose API Integration.

Does the key have to match exactly?

Yes. The key is matched exactly, and only active services are checked.

Can I use the service name instead?

Yes. Use Who is on call for a service, which takes the service name.

In this article

FAQ

Where do I find a service's integration key?

Open Services, click Integration Details on the service's row, and choose API Integration.

Does the key have to match exactly?

Yes. The key is matched exactly, and only active services are checked.

Can I use the service name instead?

Yes. Use Who is on call for a service, which takes the service name.