From ecbdc4227ba49eca622812b7413aa877318fd7a0 Mon Sep 17 00:00:00 2001 From: Daenney Date: Mon, 5 May 2025 16:22:45 +0000 Subject: [chore] Simplify the OTEL setup (#4110) # Description This simplifies our OTEL setup by: * Getting rid of some deprecated things. * Using `autoexport` and letting things get configured by the `OTEL_` environment variables. * Removing all the unnecessary config options. ## Checklist Please put an x inside each checkbox to indicate that you've read and followed it: `[ ]` -> `[x]` If this is a documentation change, only the first checkbox must be filled (you can delete the others if you want). - [x] I/we have read the [GoToSocial contribution guidelines](https://codeberg.org/superseriousbusiness/gotosocial/src/branch/main/CONTRIBUTING.md). - [x] I/we have discussed the proposed changes already, either in an issue on the repository, or in the Matrix chat. - [x] I/we have not leveraged AI to create the proposed changes. - [x] I/we have performed a self-review of added code. - [x] I/we have written code that is legible and maintainable by others. - [ ] I/we have commented the added code, particularly in hard-to-understand areas. - [x] I/we have made any necessary changes to documentation. - [ ] I/we have added tests that cover new code. - [x] I/we have run tests and they pass locally with the changes. - [x] I/we have run `go fmt ./...` and `golangci-lint run`. Reviewed-on: https://codeberg.org/superseriousbusiness/gotosocial/pulls/4110 Reviewed-by: tobi Co-authored-by: Daenney Co-committed-by: Daenney --- docs/configuration/observability.md | 51 ++++++++++++++++--------------------- 1 file changed, 22 insertions(+), 29 deletions(-) (limited to 'docs/configuration') diff --git a/docs/configuration/observability.md b/docs/configuration/observability.md index 0fcf4710e..0f1a420a4 100644 --- a/docs/configuration/observability.md +++ b/docs/configuration/observability.md @@ -2,10 +2,32 @@ These settings let you tune and configure certain observability related behaviours. +GoToSocial uses OpenTelemetry. The metrics and trace exporters can be configured using the standard OpenTelemetry SDK environment variables. For a full reference, see [the OpenTelemetry docs](https://opentelemetry.io/docs/languages/sdk-configuration/). + ## Metrics Before enabling metrics, [read the guide](../advanced/metrics.md) and ensure you've taken the appropriate security measures for your setup. +### Tracing + +To enable tracing, set `tracing-enabled` to `true`. + +Valid values for `OTEL_TRACES_EXPORTER` are [documented here](https://opentelemetry.io/docs/languages/sdk-configuration/general/#otel_traces_exporter). + +### Metrics + +To enable metrics, set `metrics-enabled` to `true`. By default this'll use OTLP to push metrics to an OpenTelemetry receiver. + +Valid values for `OTEL_METRICS_EXPORTER` are [documented here](https://opentelemetry.io/docs/languages/sdk-configuration/general/#otel_metrics_exporter) + +For Prometheus, set `OTEL_METRICS_EXPORTER` to `prometheus`. This will start a **second** HTTP server, bound for `localhost:9464` with the OpenTelemetry metrics. You can change this using: +* `OTEL_EXPORTER_PROMETHEUS_HOST` +* `OTEL_EXPORTER_PROMETHEUS_PORT` + +### Authentication + +If you want to expose the metrics with authentication, you'll need a reverse proxy. You can configure it to proxy to `http://localhost:9464/metrics` and handle authentication in your reverse proxy however you like. + ## Settings ```yaml @@ -22,36 +44,7 @@ request-id-header: "X-Request-Id" # Default: false tracing-enabled: false -# String. Set the transport protocol for the tracing system. Can either be "grpc" -# for OTLP gRPC, or "http" for OTLP HTTP. -# Options: ["grpc", "http"] -# Default: "grpc" -tracing-transport: "grpc" - -# String. Endpoint of the trace ingester. When using the gRPC or HTTP based -# transports, provide the endpoint as a single address/port combination without a -# protocol scheme. -# Examples: ["localhost:4317"] -# Default: "" -tracing-endpoint: "" - -# Bool. Disable TLS for the gRPC and HTTP transport protocols. -# Default: false -tracing-insecure-transport: false - # Bool. Enable OpenTelemetry based metrics support. # Default: false metrics-enabled: false - -# Bool. Enable HTTP Basic Authentication for Prometheus metrics endpoint. -# Default: false -metrics-auth-enabled: false - -# String. Username for Prometheus metrics endpoint. -# Default: "" -metrics-auth-username: "" - -# String. Password for Prometheus metrics endpoint. -# Default: "" -metrics-auth-password: "" ``` \ No newline at end of file -- cgit v1.2.3