> ## Documentation Index
> Fetch the complete documentation index at: https://docs.steadwing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SigNoz

> Steadwing queries SigNoz for metrics, logs, distributed traces, and alerts to correlate OpenTelemetry observability data with production incidents during root cause analysis.

## What does the SigNoz integration do?

Steadwing connects to SigNoz to query metrics, logs, distributed traces, and alerts from your SigNoz instance. During root cause analysis, Steadwing correlates SigNoz observability data with production incidents to identify the underlying causes.

## Why Use SigNoz with Steadwing?

<CardGroup cols={2}>
  <Card title="Distributed Tracing" icon="workflow">
    Analyze request flows across microservices to identify bottlenecks
  </Card>

  <Card title="Metrics Correlation" icon="chart-line">
    Correlate system metrics with incidents for deeper insights
  </Card>

  <Card title="Log Analysis" icon="file-text">
    Search and analyze logs to pinpoint errors and anomalies
  </Card>

  <Card title="Alert Context" icon="bell">
    Link SigNoz alerts to incidents for comprehensive analysis
  </Card>
</CardGroup>

## How do I connect SigNoz to Steadwing?

### Step 1: Get SigNoz API Key

1. Log in to your SigNoz dashboard
2. Navigate to **Settings** → **Workspace Settings** → **API Key**
3. Copy your existing API key or create a new one
4. Save the API key securely

<Info>
  For SigNoz Cloud users, your instance URL will be in the format: `https://ingest.{region}.signoz.cloud`
</Info>

### Step 2: Connect SigNoz in Steadwing

1. Navigate to [Steadwing Settings](https://app.steadwing.com/settings)
2. Find the **SigNoz** integration card
3. Click to expand the collapsible form
4. Enter your configuration:
   * **SigNoz URL**: Your SigNoz instance URL (e.g., `https://your-instance.signoz.io` or `https://ingest.{region}.signoz.cloud` for SigNoz Cloud)
   * **SigNoz API Key**: Paste your API key
5. Toggle the switch to **Enable** the integration

## What data does Steadwing pull from SigNoz?

### Data Collection

Steadwing queries SigNoz for:

* **Metrics** - System and application metrics (CPU, memory, custom metrics)
* **Logs** - Application logs with structured fields and context
* **Traces** - Distributed traces showing request flows across services
* **Alerts** - Alert history and current alert states

## What permissions does the SigNoz integration need?

### Instance Types

**Self-Hosted SigNoz:**

* URL format: `https://your-instance.signoz.io`
* Requires network access to your instance

**SigNoz Cloud:**

* URL format: `https://ingest.{region}.signoz.cloud`
* Supported regions: `us`, `eu`, `in`

### Supported Features

* Metrics monitoring and querying
* Log aggregation and search
* Distributed trace analysis
* Alert history and correlation
* Custom dashboards and queries

### Limitations

* Historical data limited to SigNoz's retention policy
* Rate limits apply based on your SigNoz plan
* API key must have read permissions

## FAQs

<AccordionGroup>
  <Accordion title="What SigNoz data does Steadwing access?">
    Steadwing reads metrics, logs, traces, and alert data. It does NOT modify any SigNoz data or configurations.
  </Accordion>

  <Accordion title="Can I use SigNoz Cloud with Steadwing?">
    Yes, both self-hosted SigNoz and SigNoz Cloud are supported. Make sure to use the correct URL format for your deployment type.
  </Accordion>

  <Accordion title="What permissions does the API key need?">
    The API key needs read access to metrics, logs, traces, and alerts. Write permissions are not required.
  </Accordion>

  <Accordion title="What if my API key is compromised?">
    Immediately revoke the key in SigNoz Settings and create a new one. Update the new key in Steadwing Settings to restore the integration.
  </Accordion>

  <Accordion title="Can I see which SigNoz data Steadwing analyzed?">
    Yes, the RCA report includes links to relevant traces, metrics, and logs that were analyzed during the investigation.
  </Accordion>
</AccordionGroup>

Need additional help? Please reach out to us at [hello@steadwing.com](mailto:hello@steadwing.com)