Menu
Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Alerts and IRMbreadcrumb arrow IRMbreadcrumb arrow Managebreadcrumb arrow Settings
Grafana Cloud RSS

Manage settings for Grafana IRM

The Admin & API settings in Grafana IRM provide organization-wide controls that determine how users and teams interact with incident response workflows.

From these settings, administrators can:

  • Configure which notification channels are available to users
  • Enable manual management of direct paging integrations
  • Set requirements for alert resolution notes
  • Access IRM service API endpoints

To access these settings:

  1. In the Grafana Cloud main menu, navigate to Alerts & IRM > IRM
  2. Click Settings
  3. Select the Admin & API tab

Notification channel visibility

Control which notification channels are available to users by enabling or disabling specific integrations, such as Slack or Microsoft Teams.

When you install a notification integration, its associated notification channel becomes available in users' personal notification rules by default.

When you disable a notification channel:

  • Users can no longer use the channel as a notification method in their personal notification rules
  • The channel’s configuration tab is hidden from the user’s Profile > IRM tab

Note

Disabling a notification channel only affects its visibility to users. The underlying integration remains active. To manage integration configurations, navigate to IRM > Integrations > Apps. For more information, refer to IRM Integrations.

Manually manage direct paging

Enable manual control over direct paging integrations in your organization.

By default, Grafana IRM automatically creates and manages direct paging integrations for each team. These integrations allow teams to be paged directly through the UI, messaging apps, or API.

When you enable the Manually manage direct paging integrations setting:

  • You take manual control over the creation and management of direct paging integrations
  • Grafana IRM stops automatically creating direct paging integrations for new teams
  • Existing direct paging integrations remain unchanged and can be managed manually

This setting is particularly useful for teams that want to manage their direct paging integrations through infrastructure as code (IaC) tools like Terraform or Crossplane.

Note

Enabling this setting does not delete existing direct paging integrations. You can either import existing integrations into your IaC tooling or delete and recreate them manually.

Require resolution notes

Enable this setting to enforce documentation requirements when closing alert groups.

When enabled, responders must provide a resolution note before closing an alert group. This requirement helps teams maintain consistent response process and improve post-incident visibility.

Access IRM API endpoints

The Admin & API tab displays the base URLs for IRM service APIs:

  • OnCall API URL: http://oncall-engine.default.svc.cluster.local:8080
  • Incident API URL: http://incident-api.incident.svc.cluster.local:8080

Use these endpoints to programmatically interact with IRM services, configure integrations, or implement infrastructure-as-code solutions.

For more information about using the IRM APIs, refer to the IRM API documentation.

Note

OnCall API keys are being deprecated. While existing tokens will continue to work, we recommend using Grafana Cloud service account tokens for all new API authentication.