Reference
Use this section for configuration details, security, troubleshooting, and compatibility reference.
SDK reference
-
Supported Agentic Stacks — supported providers, agent frameworks, vector databases, web/serverless runtimes, and compatibility behavior.
-
Security and Data Handling — exported data, prompt-content controls, masking, network requirements, and runtime reliability.
-
Troubleshooting Agent Data — diagnose missing, incomplete, or incorrectly attributed telemetry.
Common SDK environment variables
|
Variable |
Purpose |
|---|---|
|
|
Mavvrik tenant identity |
|
|
SDK agent identity |
|
|
Authentication to Mavvrik |
|
|
Set |
|
|
Restrict enabled integrations |
|
|
SDK logging level |
|
|
Global reporting tags |
|
|
Exclude hosts from supported HTTP instrumentation |
|
|
Print telemetry locally instead of exporting |
|
|
Print the complete local JSON payload |
Configuration precedence
SDK settings are resolved in this order:
-
built-in defaults;
-
values passed to
instrument(); -
MVK_*environment variables.
Environment variables take precedence.
Business context fields
Python uses snake_case. JavaScript / TypeScript uses camelCase.
|
Meaning |
Python |
JavaScript / TypeScript |
|---|---|---|
|
User |
|
|
|
User email |
|
|
|
Session |
|
|
|
Customer |
|
|
|
Application |
|
|
|
Use case |
|
|
|
Request |
|
|
|
Region |
|
|
|
Tags |
|
|
See Add Business Context.
Metered usage fields
|
Field |
Meaning |
|---|---|
|
metric name |
Consumed resource, for example |
|
quantity |
Number of consumed units |
|
UOM |
|
|
|
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.
export MVK_LOG_PROMPTS_RESPONSES=true
Custom masking patterns:
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.