Supported Providers
Grafana OnCall Provider
Grafana Oncall Provider is a class that allows to ingest/digest data from Grafana OnCall.
Inputs
- title (required): The title of the incident.
- roomPrefix (optional): Prefix for the incident room (default: “incident”).
- labels (optional): List of labels to associate with the incident (default: [“keep-generated”]).
- isDrill (optional): Whether the incident is a drill or not (default: False).
- severity (optional): Severity of the incident (default: “minor”).
- status (optional): Status of the incident (default: “active”).
- attachCaption (optional): Caption for any attachment.
- attachURL (optional): URL for any attachment.
- incidentID (optional): ID of an existing incident to update.
Outputs
Grafana Oncall Provider does not currently support the query
function.
Authentication Parameters
The Grafana Oncall Provider uses API token authentication. You need to provide the following authentication parameters to connect to Grafana OnCall:
- token (required): Your Grafana OnCall API Token.
- host (required): The URL of your Grafana OnCall host (e.g., https://keephq.grafana.net).
Connecting with the Provider
To connect to Grafana OnCall, you need to create an API Token:
- Log in to your Grafana OnCall account.
- Go to the API Tokens page.
- Click the Generate Token button and provide a name for your token.
- Copy the token value and keep it secure.
- Add the token value to the
authentication
section in the Grafana Oncall Provider configuration.
Notes
- This provider allows you to interact with Grafana OnCall to create or update incidents.
- The
random_color
function generates a random color for incident labels. - The
startTime
andendTime
parameters use ISO-8601 format. - The
notify
function returns information about the incident created or updated.
Payload example: