Setup with Oodle

This demo is made to show you how to connect you Oodle dashboard to a Varnish Enterprise Server.

Set-up an Oodle account

If you don’t have an Oodle account, here is the link to there page to Get Started for Free.

Once logged into the dashboard, you will need the metrics_endpoint and X-API-KEY. These can be found by clicking on Settings and then Integrations in the bottom left, and then OpenTelemetry from the options on the top right. For more information on Oodle’s OpenTelemetry ingestion, you can find their documentation here.

Configure a Service File and systemd Drop-In

The following step ensures that data is sent to Oodle via the varnish-otel service.

mkdir -p /etc/systemd/system/varnish-otel.service.d
cat << EOF > /etc/systemd/system/varnish-otel.service.d/oodle.conf
[Service]
Environment=OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
Environment=OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=<metrics_endpoint>
Environment=OTEL_EXPORTER_OTLP_HEADERS=x-api-key=<X-API-KEY>,X-OODLE-IGNORE-SCOPE-NAME=true
Environment=OTEL_SERVICE_NAME=varnish-otel-exporter
EOF

Note to replace the <metrics_endpoint> and <X-API-KEY> with the values gathered before.

With the drop-in made, we need to restart the service to apply the configurations:

systemctl daemon-reload
systemctl restart varnish-otel.service

Testing

To test the configuration is working, you can send some curl requests to localhost like so:

# this is only for testing so you can expect a 503 from Varnish

curl localhost:6081/this-is-a-test

Then, if you go to Explore Metrics on the menu to the left, you should find the Varnish exports under Select a Metric.