# Telemetry Attribute Audit

> Telemetry Attribute Audit is a paid API for AI agents from api.zfinia.com, paid per call via x402, $0.12/call, status unknown (last checked 2026-10-19).

Audits a batch of telemetry records against a declared attribute contract, flagging missing required attributes, undeclared attributes, type conflicts, and high-cardinality attributes that could explode metrics backend costs.

## Facts

- Endpoint: POST https://api.zfinia.com/x402/v1/telemetry-attribute-contract-audit?utm_source=zero.xyz
- Price: $0.12/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/telemetry-attribute-audit-5ca57302
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ctbBZFHKTTwcNY7Ker5ZV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability telemetry-attribute-audit-5ca57302 -d '<json body>'
```

Example prompt: Audit these 500 telemetry span records against my attribute contract — required fields are 'service.name', 'http.method', and 'trace_id', allow_undeclared is false, and flag any attribute whose distinct values exceed 100, since I'm worried about cardinality explosions in my metrics backend.

## When to prefer this

Choose this endpoint when you need to enforce a declared attribute contract on telemetry data AND also need cardinality analysis in a single pass — it combines schema-level contract validation (missing, undeclared, type conflicts) with the cardinality check that static schema validators cannot perform. Prefer this over generic JSON schema validators when working with OpenTelemetry spans, metrics, or logs where high-cardinality attributes are a cost and performance risk.

## Known failure modes

- Empty or malformed records array returns validation error
- Contract object with invalid type definitions causes rejection
- Cardinality limit below 1 is rejected by schema
- Batch exceeding 2000 records is refused
- Attribute pointer referencing a non-existent path produces empty results
- Missing required contract fields may produce partial audit output

## How this service works

Audit telemetry attributes against a contract, and against the thing a schema cannot see: cardinality. Reports missing required attributes, undeclared attributes, an attribute appearing as two types across the batch, and an attribute whose distinct values exceed your limit - because in a metrics backend each distinct value is a separate series, and that is how an index or a bill explodes.

## Output

Returns a structured audit report identifying: (1) required attributes missing from records, (2) undeclared attributes present but not in the contract, (3) attributes that appear with two or more conflicting types across the batch, and (4) attributes whose count of distinct values exceeds the specified cardinality limit — enabling teams to fix instrumentation before ingestion causes index bloat or runaway billing.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "records": {
   "type": "array",
   "items": {
    "type": "object"
   },
   "maxItems": 2000,
   "minItems": 1
  },
  "contract": {
   "type": "object",
   "properties": {
    "types": {
     "type": "object"
    },
    "optional": {
     "type": "array",
     "items": {
      "type": "string",
      "maxLength": 256
     },
     "maxItems": 500,
     "minItems": 1
    },
    "required": {
     "type": "array",
     "items": {
      "type": "string",
      "maxLength": 256
     },
     "maxItems": 500,
     "minItems": 1
    },
    "allow_undeclared": {
     "type": "boolean"
    }
   },
   "additionalProperties": false
  },
  "attribute_pointer": {
   "type": "string",
   "maxLength": 512
  },
  "cardinality_limit": {
   "type": "integer",
   "minimum": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/telemetry-attribute-audit-5ca57302/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zfinia.com](https://www.zero.xyz/host/api.zfinia.com/llms.txt)