Why is my Agent insights data missing?

Agent insights lets you view traces, logs, and audio recordings in LiveKit Cloud, giving you a comprehensive understanding of how your agent behaved during each session. See our documentation on Agent observability to learn more.

Agent insights are available for every session under the Agent insights tab in your project dashboard.

If you are not seeing any insights data, are only seeing partial data, or are only seeing data for a subset of sessions, follow this troubleshooting checklist:

✅  Is Observability enabled in your project settings?

Check that the feature is enabled within the Data and privacy section of your project's settings.

You do not need to restart your agent for this new setting to take effect, and it will take effect immediately for new sessions. Sessions currently in progress are unaffected by the change.

✅  Are you using an up-to-date version of the LiveKit Agents SDK?

The minimum supported versions of the Agents SDKs are as follows:

• Python SDK: 1.3.0+
• Node.js SDK: 1.0.18+
• Or, use LiveKit Agent Builder

Although these are the minimum versions, I strongly recommend using the latest version of LiveKit Agents, as we frequently add reliability improvements.

✅  Have you disabled recording for the individual session?

Although enabled by default, recording can be disabled at the session level in code as follows:

await session.start({
  record=False, # or record:false for Node.js agents
})

LiveKit Agents Python SDK version 1.4.2 also introduced a new API to enable or disable each observability feature recording individually:

await session.start(agent, record={"audio": True, "traces": False, "logs": False, "transcript": False})

✅  The data takes a short while to appear in the dashboard

Observability data should populate very soon after the session ends, but can sometimes take up to five minutes.

Waveforms are generated from the audio data which takes longer to process than traces and logs. If your session recently ended and you do not yet see waveforms, try waiting a few minutes and then refresh the page.

✅  Do you have permission to view Agent insights for the project?

You can add multiple team members to a project through the member settings page on your LiveKit Cloud dashboard. All projects can add Admin users, but projects on the Scale plan or higher can add users with Read or Write roles. If you only have Read or Write permission, you will not be able to see the insights data for that project.

✅  Are you self-hosting LiveKit?

Agent insights is supported for developers hosting their agents in LiveKit Cloud AND for developers who are self-hosting their agents.

Agent insights is restricted to LiveKit Cloud, and is therefore not available to those self-hosting the LiveKit server.

✅  Did your agent successfully upload the observability data?

If you have checked all the "quick-fix" options above, and everything looks OK, then the most likely reason you do not see observability data is that your agent did not successfully upload it to the LiveKit server.

Observability data will be uploaded from your agent to the server automatically at the end of a session, without any special handling in your code. If your agent experiences an error during shutdown, for example, a crash caused by improper resource clean-up, this can interfere with the observability upload, leading to missing data.

To confirm that you are successfully sending observability data to LiveKit Cloud, you can enable agent debug logs and look for messages like these after the session closes:

{"message": "session closed", "level": "DEBUG", "name": "livekit.agents", 
  "reason": "participant_disconnected", "error": null, "room": 
  "playground-T2o2-FaZB", "pid": 177, "job_id": "AJ_8h22k6GAUgji", 
  "room_id": "RM_JD3Bbku9ZLBT", "timestamp": "2026-03-03T13:42:12.999657+00:00"}
{"message": "uploading session report to LiveKit Cloud", "level": "DEBUG",    <--
  "name": "livekit.agents", "room": "playground-T2o2-FaZB", 
  "pid": 177, "job_id": "AJ_8h22k6GAUgji", "room_id": "RM_JD3Bbku9ZLBT", 
  "timestamp": "2026-03-03T13:42:33.876662+00:00"}
{"message": "finished uploading", "level": "DEBUG", "name": "livekit.agents", <--
  "room": "playground-T2o2-FaZB", "pid": 177, "job_id": "AJ_8h22k6GAUgji", 
  "room_id": "RM_JD3Bbku9ZLBT", "timestamp": "2026-03-03T13:42:34.034757+00:00"}

Note that these are DEBUG logs, which you will not see in production unless you specifically enable them.

Alternatively, to test that your agent is successfully shutting down, you can add an on_session_end callback and log that success.

ℹ️  Make sure Agent insights is the correct tool for your use case

If your application or use case depends on recording the session as part of its functionality, then you are strongly urged to use Egress to export the recording to a cloud provider. The call recordings that are part of Agent observability, whilst useful to understand quality or performance issues during a session, should not be used as a substitute for exporting audio via Egress.

ℹ️  Perhaps something else has gone wrong?

If you have tried all of the above troubleshooting steps, and you still do not see your Agent insight data, anyone can raise an issue in our community, but please include the following information:

• The project you are seeing the issue on
• The session or sessions you are missing insights for
• Whether the behaviour is intermittent, or consistent for all sessions.

Note that the community is not a paid support channel. For more information, please see this FAQ.

Note also that LiveKit support cannot view your traces unless you explicitly share the sessions with them.