docs: update otel related information
This commit is contained in:
parent
8bad9a4a28
commit
87d750e573
3 changed files with 26 additions and 11 deletions
|
@ -164,16 +164,16 @@ The following table shows a configuration option's name, type, and the default v
|
||||||
|[enable-opentelemetry](#enable-opentelemetry)|bool|"false"||
|
|[enable-opentelemetry](#enable-opentelemetry)|bool|"false"||
|
||||||
|[opentelemetry-trust-incoming-span](#opentelemetry-trust-incoming-span)|bool|"true"||
|
|[opentelemetry-trust-incoming-span](#opentelemetry-trust-incoming-span)|bool|"true"||
|
||||||
|[opentelemetry-operation-name](#opentelemetry-operation-name)|string|""||
|
|[opentelemetry-operation-name](#opentelemetry-operation-name)|string|""||
|
||||||
|[opentelemetry-config](#/etc/ingress-controller/telemetry/opentelemetry.toml)|string|"/etc/ingress-controller/telemetry/opentelemetry.toml"||
|
|[opentelemetry-config](#/etc/nginx/opentelemetry.toml)|string|"/etc/nginx/opentelemetry.toml"||
|
||||||
|[otlp-collector-host](#otlp-collector-host)|string|""||
|
|[otlp-collector-host](#otlp-collector-host)|string|""||
|
||||||
|[otlp-collector-port](#otlp-collector-port)|int|4317||
|
|[otlp-collector-port](#otlp-collector-port)|int|4317||
|
||||||
|[otel-max-queuesize](#otel-max-queuesize)|int|||
|
|[otel-max-export-batch-size](#otel-max-export-batch-size)|int|512||
|
||||||
|[otel-schedule-delay-millis](#otel-schedule-delay-millis)|int|||
|
|[otel-max-queuesize](#otel-max-queuesize)|int|2048||
|
||||||
|[otel-max-export-batch-size](#otel-max-export-batch-size)|int|||
|
|
||||||
|[otel-service-name](#otel-service-name)|string|"nginx"||
|
|
||||||
|[otel-sampler](#otel-sampler)|string|"AlwaysOff"||
|
|
||||||
|[otel-sampler-parent-based](#otel-sampler-parent-based)|bool|"false"||
|
|[otel-sampler-parent-based](#otel-sampler-parent-based)|bool|"false"||
|
||||||
|[otel-sampler-ratio](#otel-sampler-ratio)|float|0.01||
|
|[otel-sampler-ratio](#otel-sampler-ratio)|float|0.01||
|
||||||
|
|[otel-sampler](#otel-sampler)|string|"AlwaysOn"||
|
||||||
|
|[otel-schedule-delay-millis](#otel-schedule-delay-millis)|int|5000||
|
||||||
|
|[otel-service-name](#otel-service-name)|string|"nginx"||
|
||||||
|[main-snippet](#main-snippet)|string|""||
|
|[main-snippet](#main-snippet)|string|""||
|
||||||
|[http-snippet](#http-snippet)|string|""||
|
|[http-snippet](#http-snippet)|string|""||
|
||||||
|[server-snippet](#server-snippet)|string|""||
|
|[server-snippet](#server-snippet)|string|""||
|
||||||
|
@ -1089,10 +1089,23 @@ Specifies the port to use when uploading traces. _**default:**_ 4317
|
||||||
|
|
||||||
Specifies the service name to use for any traces created. _**default:**_ nginx
|
Specifies the service name to use for any traces created. _**default:**_ nginx
|
||||||
|
|
||||||
## opentelemetry-trust-incoming-span: "true"
|
## opentelemetry-trust-incoming-span:
|
||||||
|
|
||||||
Enables or disables using spans from incoming requests as parent for created ones. _**default:**_ true
|
Enables or disables using spans from incoming requests as parent for created ones. _**default:**_ true
|
||||||
|
|
||||||
## otel-sampler-parent-based
|
## otel-max-export-batch-size
|
||||||
|
|
||||||
|
The maximum batch size. Must be equal or smaller than [otel-max-export-batch-size](#otel-max-export-batch-size). _**default:**_ 512
|
||||||
|
|
||||||
|
## otel-schedule-delay-millis
|
||||||
|
|
||||||
|
The interval, in milliseconds, between two consecutive exports. _**default:**_ 5000
|
||||||
|
|
||||||
|
## otel-max-queuesize
|
||||||
|
|
||||||
|
The maximum queue size. _**default:**_ 2048
|
||||||
|
|
||||||
|
## otel-sampler-parent-based
|
||||||
|
|
||||||
Uses sampler implementation which by default will take a sample if parent Activity is sampled. _**default:**_ false
|
Uses sampler implementation which by default will take a sample if parent Activity is sampled. _**default:**_ false
|
||||||
|
|
||||||
|
@ -1104,6 +1117,8 @@ Specifies sample rate for any traces created. _**default:**_ 0.01
|
||||||
|
|
||||||
Specifies the sampler to be used when sampling traces. The available samplers are: AlwaysOff, AlwaysOn, TraceIdRatioBased, remote. _**default:**_ AlwaysOff
|
Specifies the sampler to be used when sampling traces. The available samplers are: AlwaysOff, AlwaysOn, TraceIdRatioBased, remote. _**default:**_ AlwaysOff
|
||||||
|
|
||||||
|
AlwaysOn is equivalent to setting [otel-sampler-ratio](#otel-sampler-ratio) to "1" and otel-sampler to "TraceIdRatioBased".
|
||||||
|
|
||||||
## main-snippet
|
## main-snippet
|
||||||
|
|
||||||
Adds custom configuration to the main section of the nginx configuration.
|
Adds custom configuration to the main section of the nginx configuration.
|
||||||
|
|
|
@ -888,10 +888,10 @@ func NewDefault() Configuration {
|
||||||
BindAddressIpv4: defBindAddress,
|
BindAddressIpv4: defBindAddress,
|
||||||
BindAddressIpv6: defBindAddress,
|
BindAddressIpv6: defBindAddress,
|
||||||
OpentelemetryTrustIncomingSpan: true,
|
OpentelemetryTrustIncomingSpan: true,
|
||||||
OpentelemetryConfig: "/etc/ingress-controller/telemetry/opentelemetry.toml",
|
OpentelemetryConfig: "/etc/nginx/opentelemetry.toml",
|
||||||
OtlpCollectorPort: "4317",
|
OtlpCollectorPort: "4317",
|
||||||
OtelServiceName: "nginx",
|
OtelServiceName: "nginx",
|
||||||
OtelSampler: "AlwaysOn",
|
OtelSampler: "AlwaysOff",
|
||||||
OtelSamplerRatio: 0.01,
|
OtelSamplerRatio: 0.01,
|
||||||
OtelSamplerParentBased: true,
|
OtelSamplerParentBased: true,
|
||||||
OtelScheduleDelayMillis: 5000,
|
OtelScheduleDelayMillis: 5000,
|
||||||
|
|
|
@ -1014,7 +1014,7 @@ max_export_batch_size = {{ .OtelMaxExportBatchSize }}
|
||||||
name = "{{ .OtelServiceName }}" # Opentelemetry resource name
|
name = "{{ .OtelServiceName }}" # Opentelemetry resource name
|
||||||
|
|
||||||
[sampler]
|
[sampler]
|
||||||
name = "{{ .OtelSampler }}" # Also: AlwaysOff, TraceIdRatioBased
|
name = "{{ .OtelSampler }}" # Also: AlwaysOn, AlwaysOff, TraceIdRatioBased
|
||||||
ratio = {{ .OtelSamplerRatio }}
|
ratio = {{ .OtelSamplerRatio }}
|
||||||
parent_based = {{ .OtelSamplerParentBased }}
|
parent_based = {{ .OtelSamplerParentBased }}
|
||||||
`
|
`
|
||||||
|
|
Loading…
Reference in a new issue