Grafana

​

Overview

The Grafana integration enables Steadwing to access your Prometheus metrics and Loki logs during incident analysis. This helps our AI identify root causes faster by analyzing your observability data - from error rates and latency spikes to application logs and stack traces.

​

Why Use Grafana with Steadwing?

​

Setup Instructions

​

Step 1: Get Your Grafana URL

Your Grafana web address. Examples:

• Grafana Cloud: https://yourcompany.grafana.net
• Self-hosted: https://grafana.yourcompany.com
• AWS EC2: https://ec2-xx-xx-xx-xx.compute.amazonaws.com:3000
• On-premises: https://10.0.1.50:3000

​

Step 2: Create a Service Account Token

1. Open Grafana and navigate to Administration → Service Accounts
   • Direct link: https://your-grafana-url/org/serviceaccounts
2. Click Add service account
3. Configure the account:
   • Display name: Steadwing Integration (or your preferred name)
   • Role: Viewer (read-only access)
4. Click Create
5. Click Add service account token
6. Configure the token:
   • Display name: Steadwing Token
   • Expiration: Choose your preferred duration (or no expiration)
7. Click Generate token
8. Copy the token (starts with glsa_...)

​

Step 3: Connect Grafana in Steadwing

1. Navigate to Steadwing Settings
2. Find the Grafana integration card
3. Click to expand the collapsible form
4. Fill in the required fields:
   • Grafana URL: Your Grafana web address (e.g., https://yourcompany.grafana.net)
   • Service Account Token: Your token (starts with glsa_)
5. Toggle the switch to Enable the integration

​

Step 4: Verify Connection

1. Return to Steadwing Settings
2. Confirm the Grafana integration shows as Connected
3. You’re all set! Steadwing will now use your Grafana data during incident analysis

​

How It Works

When analyzing an incident, Steadwing automatically:

1. Checks your Grafana for Prometheus and Loki datasources
2. Queries Prometheus metrics (if available) - error rates, CPU/memory usage, latency
3. Queries Loki logs (if available) - error messages, stack traces, application logs
4. Correlates metric spikes with log errors to find patterns
5. Combines findings with code analysis to identify the root cause
6. Provides evidence-based diagnosis with relevant metrics and logs

No manual searching required!

​

Requirements

• Grafana version: 9.0 or newer
• Service account role: Viewer (read-only)
• Datasources: At least one of:
  • Prometheus (for metrics)
  • Loki (for logs)
  • Both (recommended for best results)

​

Datasource Flexibility

The integration automatically adapts to what you have:

​

What Data Can Steadwing Access?

Prometheus Metrics:

• Performance data (CPU, memory, latency)
• Error rates and request counts
• Custom application metrics
• Only data around incident timeframes

Loki Logs:

• Application logs and error messages
• Stack traces and exceptions
• Service logs for affected applications
• Only relevant time ranges

Security: Read-only access. Cannot modify dashboards, alerts, or data.

​

Uninstall

To disconnect the integration:

1. In Steadwing Settings, disable the Grafana integration
2. In Grafana, delete the service account:
   • Navigate to Administration → Service Accounts
   • Find “Steadwing Integration” (or your chosen name)
   • Click Delete service account

This immediately revokes access.

​

FAQs

Need additional help? Please reach out to us at [email protected]