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

# Telemetry

> Connect the logs, metrics, traces, and dashboards your team relies on.

Telemetry gives investigations the hard signal that explains what your system was actually doing: error spikes, latency changes, log lines, and the dashboards your team already trusts. Connect the observability tools your responders reach for during an incident, and investigations can query them directly to confirm or rule out a hypothesis. Because an investigation learns the shape of each source, including the queries in your own dashboards, it queries them the way an engineer who knows your systems would, not with generic guesses.

It's also the evidence that carries the most weight: verifying a hypothesis against live system state is what gives an investigation the most [conviction](/investigations/how-investigations-work#building-conviction) in a finding.

## What you can connect

Connect a provider to bring several data sources at once, or connect a data source directly.

**Providers**

<CardGroup cols={2}>
  <Card title="Grafana" icon="database" href="/investigations/connect/telemetry/grafana">
    Loki, Prometheus, Tempo, and Pyroscope.
  </Card>

  <Card title="Google Cloud" icon="cloud" href="/investigations/connect/telemetry/google-cloud">
    Cloud Logging, Cloud Monitoring, and Cloud Trace.
  </Card>
</CardGroup>

**Connect directly**

<CardGroup cols={2}>
  <Card title="Datadog" icon="database" href="/investigations/connect/telemetry/datadog">
    Logs, metrics, traces, and error tracking.
  </Card>

  <Card title="Elasticsearch" icon="database" href="/investigations/connect/telemetry/elasticsearch">
    Logs from your index patterns.
  </Card>

  <Card title="OpenSearch" icon="database" href="/investigations/connect/telemetry/opensearch">
    Logs from your index patterns.
  </Card>

  <Card title="Honeycomb" icon="database" href="/investigations/connect/telemetry/honeycomb">
    Traces and spans from your environments.
  </Card>

  <Card title="Sumo Logic" icon="database" href="/investigations/connect/telemetry/sumo-logic">
    Logs and metrics from your account.
  </Card>

  <Card title="PostgreSQL" icon="database" href="/investigations/connect/telemetry/postgresql">
    Read-only SQL queries.
  </Card>

  <Card title="MySQL" icon="database" href="/investigations/connect/telemetry/mysql">
    Read-only SQL queries.
  </Card>

  <Card title="HTTP API" icon="server" href="/investigations/connect/telemetry/http">
    Any HTTP API you describe.
  </Card>

  <Card title="MCP server" icon="server" href="/investigations/connect/telemetry/mcp">
    Any remote MCP server.
  </Card>
</CardGroup>

## How telemetry is modeled

Some tools host others. Connect **Grafana** once, and investigations can discover the data sources behind it: Loki for logs, Prometheus for metrics, Tempo for traces, and more. The same pattern applies to **Google Cloud** (which exposes projects). You connect the provider once, then choose which of the discovered data sources to enable.

Other tools (Honeycomb, Elasticsearch, your databases) are connected directly and stand on their own.

### Capabilities

Each data source provides one or more capabilities, which is what investigations actually use it for:

| Capability | What it answers                                              |
| ---------- | ------------------------------------------------------------ |
| Logs       | What was the system logging around the time of the incident? |
| Metrics    | Did error rates, latency, or saturation change?              |
| Traces     | Where did a slow or failing request spend its time?          |
| SQL        | What does the data in this database actually show?           |
| Dashboards | What do the views my team already built reveal?              |

## Enabling data sources

Each data source has an **enabled** toggle that controls whether investigations can use it. When a provider is first connected, some data sources are enabled by default and others are left off so you stay in control:

* Read-only and low-risk sources (such as traces) tend to be on by default.
* Sources that allow broader querying (such as logs) tend to be off by default, so you opt in deliberately.

Review the enabled data sources after connecting a provider and turn on the ones your team uses.

## Learning your stack

Investigations don't query blindly. For each connected data source we continually learn how to query it well in your environment, discovering its real labels and fields, learning the query patterns in your own dashboards, and remembering what worked in past investigations. That's what lets a query filter on the attributes you actually use and reach for sensible defaults, instead of guessing against an unfamiliar stack.

Routing a question to the right data source, translating it into the right query language, and the guidance and memory the system builds over time all sit behind this. See [How telemetry works](/investigations/connect/telemetry/how-it-works) for the full picture.

<Tip>
  Connect the data sources and dashboards your team reaches for during real incidents. The more your setup reflects your
  real workflow, the better investigations learn to query it.
</Tip>

## Related

<CardGroup cols={2}>
  <Card title="How telemetry works" icon="magnifying-glass" href="/investigations/connect/telemetry/how-it-works">
    Routing, query planning, guidance, and memory.
  </Card>

  <Card title="How investigations work" icon="https://mintcdn.com/incidentio-18bb4170/sRvzAk-yzIz8QOX3/icons/investigations.svg?fit=max&auto=format&n=sRvzAk-yzIz8QOX3&q=85&s=cf0971ce90cba6e9bee684c6deca9a51" href="/investigations/how-investigations-work#querying-your-telemetry" width="40" height="40" data-path="icons/investigations.svg">
    How telemetry queries become evidence in a finding.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/investigations/connect/telemetry/troubleshooting">
    Why a data source's queries fail, and what to do about it.
  </Card>
</CardGroup>
