---
title: "Troubleshoot Tempo | Grafana Tempo documentation"
description: "Learn how to troubleshoot operational issues for Grafana Tempo."
---

# Troubleshoot Tempo

This section helps with day zero operational issues that may come up when getting started with Tempo. The documents walk you through debugging each part of the ingestion and query pipeline to diagnose issues.

In addition, the [Tempo runbook](https://github.com/grafana/tempo/blob/main/operations/tempo-mixin/runbook.md) can help with remediating operational issues.

## Sending traces

- [Spans are being refused with “pusher failed to consume trace data”](/docs/tempo/latest/troubleshooting/send-traces/max-trace-limit-reached/)
- [Is Grafana Alloy sending to the backend?](/docs/tempo/latest/troubleshooting/send-traces/alloy/)

## Querying

- [Unable to find my traces in Tempo](/docs/tempo/latest/troubleshooting/querying/unable-to-see-trace/)
- [Error message “Too many jobs in the queue”](/docs/tempo/latest/troubleshooting/querying/too-many-jobs-in-queue/)
- [Queries fail with 500 and “error using pageFinder”](/docs/tempo/latest/troubleshooting/querying/bad-blocks/)
- [I can search traces, but there are no service name or span name values available](/docs/tempo/latest/troubleshooting/querying/search-tag/)
- [Error message `response larger than the max (<number> vs <limit>)`](/docs/tempo/latest/troubleshooting/querying/response-too-large/)
- [Search results don’t match trace lookup results with long-running traces](/docs/tempo/latest/troubleshooting/querying/long-running-traces/)

## Metrics-generator

- [Metrics or service graphs seem incomplete](/docs/tempo/latest/troubleshooting/metrics-generator/)

## Out-of-memory errors

- [Set the max attribute size to help control out of memory errors](/docs/tempo/latest/troubleshooting/out-of-memory-errors/)