Meter Definitions

The AI Guard service registers four meters under the instrument name ai-guard-server. Three are submitted by clients via POST /metric, and one is generated automatically from classification responses.

Required Attributes

All meters require the following attributes:

Supported Platform Values

Meter Reference

ai_guard.agent — Agent Response Time

Records the response time of the LLM agent. Used to track agent performance and latency trends.

SDK Example:

client.metric(MetricsEvent(
    attributes={},
    meter=MetricsEventMeter(name="ai_guard.agent", value="1234"),
))

Export Statistics (OneTrust exporter):

ai_guard.user — User Session

Records user interactions and session starts. Used to track engagement metrics.

SDK Example:

client.metric(MetricsEvent(
    attributes={"new_session": "true"},
    meter=MetricsEventMeter(name="ai_guard.user", value="1"),
))

ai_guard.redact — Redaction Event

Records redaction and block events. Used to track how often sensitive data is detected and acted upon.

SDK Example:

client.metric(MetricsEvent(
    attributes={"action": "redact", "actor": "user"},
    meter=MetricsEventMeter(name="ai_guard.redact", value="1"),
))

ai_guard.classification — Classification Count

Automatically incremented once per classifier match in a classification response. Tracks which types of sensitive data are being detected most frequently.

⚠️

Not Submittable

This meter is generated automatically by the service. It cannot be submitted via POST /metric or client.metric().

Custom Attributes

The service supports optional additional attribute keys beyond the built-in required keys. These are configured in the metrics.allowed-attributes section of the service configuration:

metrics:
  allowed-attributes:
    - custom_key
    - environment

Attributes not in the allowed set or the required set (agent_id, platform) are rejected with a 400 Bad Request.

What's Next?

• Metrics Exporters — How metrics are exported to AI Governance
• Metrics Overview — Pipeline architecture
• Observability & Metrics (SDK) — Send metrics from your application