otel-collector
Description
This provider enables gathering and exporting OpenTelemetry data for the Garden execution.
It provides detailed insights into what a Garden command is doing at any given time and can be used for alerting on performance regressions or debugging performance issues.
It does that by running an OpenTelemetry Collector on the local machine for the duration of the command execution, which then exports the gathered data to the desired service.
Currently supported exporters are Datadog, Newrelic, Honeycomb and 'OTLP HTTP'.
Below is the full schema reference for the provider configuration..
The reference is divided into two sections. The first section contains the complete YAML schema, and the second section describes each schema key.
Complete YAML Schema
The values in the schema below are the default values.
providers:
- # The name of the provider plugin to use.
name:
# List other providers that should be resolved before this one.
#
# Example: `["exec"]`
dependencies: []
# If specified, this provider will only be used in the listed environments. Note that an empty array effectively
# disables the provider. To use a provider in all environments, omit this field.
#
# Example: `["dev","stage"]`
environments:
preInit:
# A script to run before the provider is initialized. This is useful for performing any provider-specific setup
# outside of Garden. For example, you can use this to perform authentication, such as authenticating with a
# Kubernetes cluster provider.
# The script will always be run from the project root directory.
# Note that provider statuses are cached, so this script will generally only be run once, but you can force a
# re-run by setting `--force-refresh` on any Garden command that uses the provider.
runScript:
exporters:
- name:
enabled:
verbosity: normal
Configuration Keys
providers[]
providers[]
array[object]
[]
No
providers[].name
providers[].name
providers > name
The name of the provider plugin to use.
string
Yes
providers[].dependencies[]
providers[].dependencies[]
providers > dependencies
List other providers that should be resolved before this one.
Example: ["exec"]
array
[]
No
providers[].environments[]
providers[].environments[]
providers > environments
If specified, this provider will only be used in the listed environments. Note that an empty array effectively disables the provider. To use a provider in all environments, omit this field.
Example: ["dev","stage"]
array
No
providers[].preInit
providers[].preInit
providers > preInit
object
No
providers[].preInit.runScript
providers[].preInit.runScript
providers > preInit > runScript
A script to run before the provider is initialized. This is useful for performing any provider-specific setup outside of Garden. For example, you can use this to perform authentication, such as authenticating with a Kubernetes cluster provider. The script will always be run from the project root directory. Note that provider statuses are cached, so this script will generally only be run once, but you can force a re-run by setting --force-refresh
on any Garden command that uses the provider.
string
No
providers[].exporters[]
providers[].exporters[]
providers > exporters
array
Yes
providers[].exporters[].name
providers[].exporters[].name
string
No
providers[].exporters[].enabled
providers[].exporters[].enabled
providers > exporters > enabled
boolean
No
providers[].exporters[].verbosity
providers[].exporters[].verbosity
providers > exporters > verbosity
string
"detailed", "normal", "basic"
"normal"
No
Last updated
Was this helpful?