Python · Instrumentation
openinference-instrumentation-guardrails
OpenInference Guardrails Instrumentation
- Module
openinference.instrumentation.guardrails- Version
- 0.1.33
- Python
- >=3.10, <3.15
- Instruments
guardrails-ai>=0.4.5,<0.5.1
Install
pip install openinference-instrumentation-guardrailsUsage
Instrument once, at startup, before the library is used. The GuardrailsInstrumentor reference below lists the options.
from opentelemetry.sdk.trace import TracerProvider
from openinference.instrumentation import TraceConfig
from openinference.instrumentation.guardrails import GuardrailsInstrumentor
tracer_provider = TracerProvider()
# ...add a span processor that exports to Phoenix or any OTLP backend.
GuardrailsInstrumentor().instrument(
tracer_provider=tracer_provider,
config=TraceConfig(hide_inputs=True), # optional
)openinference.instrumentation.guardrails
GuardrailsInstrumentor
classSource ↗class GuardrailsInstrumentor(BaseInstrumentor)An instrumentor for the Guardrails framework.
instrument
methoddef instrument(
*,
tracer_provider: Optional[TracerProvider] = None,
config: Optional[TraceConfig] = None,
skip_dep_check: bool = False,
) -> NoneStart tracing guardrails-ai: patch it so its calls make OpenInference spans. Calling it again does nothing. Inherited from OpenTelemetry’s BaseInstrumentor.
Parameters
| Name | Description |
|---|---|
tracer_provider | The tracer provider the spans are made with. Defaults to the global one, |
config | What the spans record: hide inputs, outputs or messages, or limit image sizes. Defaults to |
skip_dep_check | Instrument even if the installed version of |
uninstrument
methoddef uninstrument() -> NoneStop tracing: undo the patches instrument() made. Inherited from OpenTelemetry’s BaseInstrumentor.
instrumentation_dependencies
methodSource ↗def instrumentation_dependencies() -> Collection[str]