Skip to main content
Dome is OpenTelemetry compliant and allows exporting logs, traces and metrics to any OpenTelemetry compliant platform. Vijil also supports popular LLM tracing applications out-of-the-box.

W&B Weave

Weave is Weight’s and Bias’s toolkit to trace, monitor and evaluate LLMs. To integrate with Weave, simply use Dome’s apply_decorator method to add the weave.op decorator to Dome’s operations. After doing this, any uses of Dome in a Weave-enabled application will automatically include Dome execution information
In the trace, you will see all calls to Dome’s guard_input and guard_output information, including detailed information about the execution of each Guard in the Guardrail, and each Detector in the Guard. weave-example | 70%

AgentOps

Dome is also compatible with AgentOps. To integrate with AgentOps, use the apply_decorator method and add agentops.record_action() to Dome’s operations.

OpenTelemetry-Compliant Platforms

Dome offers out-of-the-box support for all OpenTelemetry compliant observability platforms such as Uptrace, Jaeger, Signoz etc. If your application is already using Opentelemetry instrumentation, you can pass your existing Tracer, Meter and Handler objects to Dome.
You do not need to provide all three objects to enable instrumentation. All three arguments are optional.

Tracing

When Dome is instrumented with a tracer, all Guardrail, Guard and Detector calls are added as spans to the current trace. Each of these spans includes the input and output to the function call, and error information, if any.

Monitoring

Each Guardrail, Guard and detection method is automatically instrumented with the following instruments when a meter is provided
  • Requests Count (requests) : The number of requests sent to the object
  • Flagged Count (flagged) : The number of requests that were flagged by the object
  • Error Count (errors) : The number of errors that were generated by that object
  • Latency (latency) : The execution time of the object
The naming scheme used for each object’s counters is [Guardrail Name].[Guard Name (if applicable)].[Detector Name (if applicable)].[Instrument Name]. These monitors can be used in the observability platform of your choice to monitor Guardrail, Guard and even detection-method level performance and statistics.

Logging

Logs from Vijil Dome are generated from Python loggers with the standard name vijil.dome. Any handlers passed to a Dome object will be added to these loggers if they are not already attached to them. Dome logs the following data at each level

DEBUG

  • Setup messages indicating initialization of Guardrails, Guards and Detectors, along with the parameters used for initialization

INFO

  • Inputs and output from each Guardrail, Guard and Detector.

WARNING

  • Missing Guardrails in configuration files
  • Detector-level execution warnings such as a string being larger than a Detectors’ context window
  • Detector or Guard timeouts when executing in parallel

ERROR

  • All errors during Guardrail, Guard and Detector execution that are handled

CRITICAL

  • Any errors in Guardrail, Guard or Detector initialization preventing their creation
  • Any unhandled exceptions
otel-instruments | 30%
Last modified on July 22, 2026