Skip to main content

Promtail

Oodle provides a seamless integration with Promtail. You can use OTel Collector Loki receiver and then export the data via OTel exporter to Oodle.

Configuration​

OTel configuration​

To configure Open Telemetry to send logs to Oodle, you'll need the following values:

  • OODLE_INSTANCE: Your Oodle instance ID. Go to Settings icon -> API Keys page in your Oodle UI to find out. (Oodle UI links: ap1, us1)
  • OODLE_API_KEY: Your Oodle API key for authentication. Go to Settings icon -> API Keys in your Oodle UI to choose an appropriate key. (Oodle UI links: ap1, us1)

You can then configure OTel collector to receive logs from Promtail again via Loki receiver

receivers:
  loki:
    protocols:
      http:
        endpoint: 0.0.0.0:3500
      grpc:
        endpoint: 0.0.0.0:3600
    use_incoming_timestamp: true

exporters:
  otlphttp/oodle:
    logs_endpoint: "https://<OODLE_ENDPOINT>-logs.collector.oodle.ai/ingest/otel/v1/logs"
    headers:
      "X-OODLE-INSTANCE": "<OODLE_INSTANCE>"
      "X-API-KEY": "<OODLE_API_KEY>"

processors:
  batch:

service:
  pipelines:
    logs:
      receivers: [loki]
      processors: [batch]
      exporters: [otlphttp/oodle]

Steps​

Promtail Integration

You can find the required Promtail configuration changes by doing the following:

  1. Login to the Oodle UI, then navigate to Settings page
  2. Click on the Promtail tile
  3. Choose an appropriate API key from the list on top of the drawer

You can then configure OTel collector to receive logs from Promtail again via Loki receiver

Promtail configuration​

You can now configure Promtail agent to send logs to OTel collector configured above:

clients:
  - url: http://otelcol:3500/loki/api/v1/push

Support​

If you need assistance or have any questions, please reach out to us through:

  • The help chat widget available on the Support link in the sidebar
  • Email at support@oodle.ai