{"slug": "inkeep-monitoring-observability-with-opentelemetry", "title": "Inkeep Monitoring & Observability with OpenTelemetry", "summary": "Inkeep has released a new integration with OpenTelemetry and SigNoz that enables monitoring and observability for AI agent applications. The setup allows developers to track model performance, capture request/response details, and monitor system-level metrics including latency, error rates, and usage trends in real-time. The integration provides full observability across agent workflows, helping teams debug issues, optimize performance, and improve user experience through correlated traces and configurable alerts in SigNoz dashboards.", "body_md": "Overview\n\nThis guide walks you through setting up monitoring and observability for Inkeep using [OpenTelemetry](https://opentelemetry.io/) and exporting traces to SigNoz. With this integration, you can observe the performance of various models, capture request/response details, and track system-level metrics in SigNoz, giving you real-time visibility into latency, error rates, and usage trends for your Inkeep applications.\n\nInstrumenting Inkeep agents in your AI applications with telemetry ensures full observability across your agent workflows, making it easier to debug issues, optimize performance, and understand user interactions. By leveraging SigNoz, you can analyze correlated traces in dashboards, configure alerts, and gain actionable insights to continuously improve reliability, responsiveness, and user experience.\n\nPrerequisites\n\nBefore getting started, ensure you have the following installed on your system:\n\n- A\n[SigNoz Cloud account](https://signoz.io/teams/)with an active ingestion key or[Self Hosted SigNoz instance](https://signoz.io/docs/install/self-host/) - Node.js version 22 or higher\n- Docker\n- pnpm version 10 or higher\n\nYou can verify by running:\n\n```\nnode --version\npnpm --version\ndocker --version\n```\n\nMonitoring Inkeep\n\nFor more information on getting started with Inkeep, visit the [Inkeep Quick Start Guide](https://docs.inkeep.com/get-started/quick-start). To learn more about setting up traces in Inkeep and sending them to SigNoz, see the [Inkeep Traces Documentation](https://docs.inkeep.com/get-started/traces).\n\nStep 1: Create a new agents project\n\nRun the Inkeep quickstart script on a target folder:\n\n```\nnpx @inkeep/create-agents my-agents\n```\n\nNavigate to the folder\n\n```\ncd my-agents\n```\n\nOpen the folder using your coding editor. To open with Cursor, you can run `cursor .`\n\nStep 2: Save Your SigNoz Credentials\n\nYou'll need to collect three pieces of information from your SigNoz dashboard:\n\n**API Key:**\n\n- Go to\n**Settings → Service Accounts** and create a new service account. - In the\n**Overview** tab, assign a role —**Viewer** is sufficient for observability. - Go to the\n**Keys** tab and click**Add Key**. - Set the expiration field to \"No Expiry\" to prevent the key from expiring.\n- Copy the generated API key.\n\nSee [Service Accounts](https://signoz.io/docs/manage/administrator-guide/iam/service-accounts/) for full details.\n\n**Ingestion Key:**\n\n- Navigate to\n**Settings → Ingestion Settings** - Set the expiration field to \"No Expiry\" to prevent the key from expiring\n- Copy the ingestion key\n\n**SigNoz URL:**\n\n- Copy the URL from your browser's address bar\n- It will look like:\n`https://<your-organization>.signoz.cloud`\n\nStep 3: Configure Your Root .env File\n\n```\n# SigNoz\nSIGNOZ_URL=https://<your-organization>.signoz.cloud\nSIGNOZ_API_KEY=<your-signoz-api-key>\n\nOTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://ingest.<region>.signoz.cloud:443/v1/traces\nOTEL_EXPORTER_OTLP_TRACES_HEADERS=signoz-ingestion-key=<your-ingestion-key>\n```\n\n`<region>`\n\n: Your[SigNoz Cloud region](https://signoz.io/docs/ingestion/signoz-cloud/overview/#endpoint)- Replace\n`<your-organization>`\n\nwith your SigNoz Cloud instance name - Replace\n`<your-signoz-api-key>`\n\nwith your SigNoz API Key. `<your-ingestion-key>`\n\n: Your SigNoz[ingestion key](https://signoz.io/docs/ingestion/signoz-cloud/keys/)\n\n```\n# SigNoz Configuration\nSIGNOZ_URL=<your-local-signoz-instance>\nSIGNOZ_API_KEY=<your-signoz-api-key>\n```\n\n- Replace\n`<your-local-signoz-instance>`\n\nwith the localhost and port you are running SigNoz on. For example:`http://localhost:8080`\n\n- Replace\n`<your-signoz-api-key>`\n\nwith your SigNoz API Key.\n\nStep 4: Run the setup script\n\nEnsure Docker Desktop (or Docker daemon) is running before running the setup script.\n\n```\npnpm setup-dev\n```\n\nOr if you are using a cloud database, you can skip the docker database startup by running:\n\n```\npnpm setup-dev --skip-docker\n```\n\nMake sure your DATABASE_URL environment variable is configured for your cloud database.\n\nStep 5: Launch the dev environment\n\n```\npnpm dev\n```\n\nThe Visual Builder will auto-open at [http://localhost:3000](http://localhost:3000).\n\nView Traces in SigNoz\n\nYour Inkeep agents usage should now automatically emit traces.\n\nYou should be able to view traces in Signoz Cloud under the traces tab:\n\nWhen you click on a trace in SigNoz, you'll see a detailed view of the trace, including all associated spans, along with their events and attributes.\n\nTroubleshooting\n\n[Troubleshooting](#troubleshooting)\n\nIf you don't see your telemetry data:\n\n**Verify network connectivity**- Ensure your application can reach SigNoz ingestion endpoints** Check ingestion key**- Verify your SigNoz ingestion key is correct** Wait for data**- OpenTelemetry batches data before sending, so wait 10-30 seconds after making API calls\n\nNext Steps\n\nYou can also check out our custom Inkeep dashboard [here](https://signoz.io/docs/dashboards/dashboard-templates/inkeep-dashboard/) which provides specialized visualizations for monitoring your Inkeep usage in applications. The dashboard includes pre-built charts specifically tailored for LLM usage, along with import instructions to get started quickly.\n\nAdditional resources:\n\n- Set up\n[alerts](https://signoz.io/docs/alerts/)for high latency or error rates - Learn more about\n[querying traces](https://signoz.io/docs/userguide/traces/) - Explore\n[log correlation](https://signoz.io/docs/userguide/logs_query_builder/)", "url": "https://wpnews.pro/news/inkeep-monitoring-observability-with-opentelemetry", "canonical_source": "https://signoz.io/docs/inkeep-monitoring", "published_at": "2026-06-11 00:00:00+00:00", "updated_at": "2026-06-12 10:00:39.009179+00:00", "lang": "en", "topics": ["ai-tools", "ai-infrastructure", "mlops", "artificial-intelligence", "ai-agents"], "entities": ["Inkeep", "OpenTelemetry", "SigNoz", "SigNoz Cloud", "Docker", "Node.js"], "alternates": {"html": "https://wpnews.pro/news/inkeep-monitoring-observability-with-opentelemetry", "markdown": "https://wpnews.pro/news/inkeep-monitoring-observability-with-opentelemetry.md", "text": "https://wpnews.pro/news/inkeep-monitoring-observability-with-opentelemetry.txt", "jsonld": "https://wpnews.pro/news/inkeep-monitoring-observability-with-opentelemetry.jsonld"}}