Datadog Log management integration
This section describes how to integrate your Aidbox with Datadog.
​Datadog offers cloud-based monitoring and analytics platform which integrates and automates infrastructure monitoring, application performance monitoring, and log management for real-time observability of customers.

Datadog logging

Please, do not use these settings withAIDBOX_ES_URL (Elastic Logs and Monitoring) enabled. These are two alternative approaches for log management.
To enable Aidbox logs uploading into Datadog, you need to set AIDBOX_DD_API_KEY environment variable.
1
AIDBOX_DD_API_KEY = <Datadog API Key>
2
# Required.
3
# Datadog API Key.
4
​
5
AIDBOX_DD_BATCH_SIZE
6
# Optional; default: 200.
7
# How many log entries to collect before uploading.
8
# Aidbox uploads logs when either at least AIDBOX_DD_BATCH_SIZE entries collected
9
# or time passed from previous log uploading exceeds AIDBOX_BATCH_TIMEOUT
10
​
11
AIDBOX_DD_BATCH_TIMEOUT
12
# Optional; default: 3600000 (1 hour)
13
# How long to wait before uploading
14
# Aidbox uploads logs when either at least AIDBOX_DD_BATCH_SIZE entries collected
15
# or time passed from previous log uploading exceeds AIDBOX_BATCH_TIMEOUT
16
​
17
AIDBOX_DD_LOGS
18
# Optional.
19
# Path to file in which logs will be written in case of error
20
# in uploading logs to Datadog.
21
# If not provided, in case of uploading error logs will be printed to stdout.
22
​
23
AIDBOX_DD_TAGS
24
# Optional.
25
# Tags associated with your logs.
26
# Convenient for transferring the name of the environment.
27
# For example "env:staging"
28
​
29
AIDBOX_DD_SITE
30
# Optional; default: datadoghq.com
31
The regional site for a Datadog customer.
32
This can only be one of datadoghq.com,us3.datadoghq.com,datadoghq.eu,ddog-gov.com
Copied!
By default, Aidbox sends logs as bundles of multiple records so if there's not enough data you won't see any logs in Datadog. For testing purposes reduce bundle size to 1 record by setting environment variable:
AIDBOX_DD_BATCH_SIZE=1
Last modified 1mo ago
Copy link