Monitor your agents

Astropods automatically monitors agents that interact with common AI model providers. After you deploy an agent, its token usage, tool calls, and latency appear on the Insights page. For deeper observability, Astropods provides adapters for common frameworks.

Agent health

An agent’s Monitor > Health page shows whether its application, memory, CPU, and activity are healthy, and when their alerts fired. Each category has a state (Normal, Warning, or Critical), its last 24 hours, and an alert history.

The alert history covers up to the last 30 days. Astropods rebuilds it from the cluster’s metrics with the same checks that raise alerts, so it includes alerts from before you first opened the page. On a cluster that keeps metrics for less than 30 days, the history covers only what the cluster still keeps.

The history shows when a condition was breached, not when a notification was sent. Astropods sends at most one notification a day for each alert, so a breach that sent no notification, such as a repeat later the same day, still appears in the history.

Framework guides

Manually attaching observability

When an adapter isn’t available for your framework, you can instrument an agent manually using standard OpenTelemetry. Every deployed agent container receives these environment variables automatically:

OTEL_EXPORTER_OTLP_ENDPOINT is unset during local development. Guard your instrumentation on the variable so the agent runs cleanly in both environments.

Node.js

bun add @opentelemetry/sdk-node @opentelemetry/exporter-trace-otlp-http @opentelemetry/resources @opentelemetry/semantic-conventions

import { NodeSDK } from "@opentelemetry/sdk-node";
import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
import { resourceFromAttributes } from "@opentelemetry/resources";
import {
  ATTR_SERVICE_NAME,
  ATTR_SERVICE_VERSION,
} from "@opentelemetry/semantic-conventions";
if (process.env.OTEL_EXPORTER_OTLP_ENDPOINT) {
  new NodeSDK({
    resource: resourceFromAttributes({
      [ATTR_SERVICE_NAME]: process.env.ASTRO_AGENT_NAME ?? "agent",
      [ATTR_SERVICE_VERSION]: process.env.ASTRO_AGENT_BUILD ?? "dev",
    }),
    traceExporter: new OTLPTraceExporter({
      url: `${process.env.OTEL_EXPORTER_OTLP_ENDPOINT}/v1/traces`,
    }),
  }).start();
}