September 2026 release is live Read More

Agent Cost & UsageReference

Reference

Use this section for configuration details, security, troubleshooting, and compatibility reference.

SDK reference

Common SDK environment variables

Variable

Purpose

MVK_TENANT_ID

Mavvrik tenant identity

MVK_AGENT_ID

SDK agent identity

MVK_API_KEY

Authentication to Mavvrik

MVK_ENABLED

Set false to disable SDK tracking

MVK_WRAPPERS

Restrict enabled integrations

MVK_LOG_LEVEL

SDK logging level

MVK_TAG_<NAME>

Global reporting tags

MVK_HTTP_EXCLUSIONS

Exclude hosts from supported HTTP instrumentation

MVK_EXPORTER_TYPE=console

Print telemetry locally instead of exporting

MVK_EXPORTER_FORMAT=json

Print the complete local JSON payload

Configuration precedence

SDK settings are resolved in this order:

  1. built-in defaults;

  2. values passed to instrument();

  3. MVK_* environment variables.

Environment variables take precedence.

Business context fields

Python uses snake_case. JavaScript / TypeScript uses camelCase.

Meaning

Python

JavaScript / TypeScript

User

user_id

userId

User email

user_email

userEmail

Session

session_id

sessionId

Customer

customer_id

customerId

Application

application_id

applicationId

Use case

use_case

useCase

Request

request_id

requestId

Region

region

region

Tags

tags

tags

See Add Business Context.

Metered usage fields

Field

Meaning

metric name

Consumed resource, for example document.pages

quantity

Number of consumed units

UOM

page, call, second, byte, etc.

rate_per_unit

Unit price when supplied with the usage

provider

Vendor or service name

currency

Pricing currency

See Track Metered Usage.

Prompt-content controls

Prompt and response text is not sent by default.

Bash
export MVK_LOG_PROMPTS_RESPONSES=true

Custom masking patterns:

Bash
export MVK_PROMPTS_MASKING_PATTERNS='["MRN-\\d{7}","POL-[A-Z]{2}\\d{6}"]'

Review Security and Data Handling before enabling content capture.

Direct-export network requirement

ingest.mavvrik.ai:443

Verify data in Mavvrik

  • Home → Agentic → Cost — spend and cost allocation.

  • Home → Agentic → Sessions — execution and session detail.