Introduction
Instrumentation Rules control how telemetry is recorded from your application. A rule can be applied to a set of Kubernetes workloads and instrumentation libraries.
Rule Types:
Configuration Options
Apply to Sources
Odigos allows you to apply/limit rules to specific sources.
- To apply a rule to all sources, omit the
workloadsfield. - To apply a rule to specific sources, provide an array of workload objects (identified by it’s namespace, name, and kind).
Odigos allows you to define multiple rules, and will merge them together to create a single rule per source. Conflicting options will be resolved by choosing to record the attribute, if it’s specified by one rule (at least).
Apply to Instrumentation Libraries
Odigos allows you to apply/limit rules to specific instrumentation libraries.
- To apply a rule to all instrumentation libraries, omit the
instrumentationLibrariesfield. - To apply a rule to specific instrumentation libraries, provide an array of instrumentation libraries (identified by it’s unique name, language, and span kind for golang).
Any rule for a specific instrumentation library will take precedence over a rule that does not specify a library.
This is an advanced feature. It is recommended to set the same rules for all instrumentation libraries, and only use this feature when you need fine-grained control.