Documentation Index
Fetch the complete documentation index at: https://docs.bronto.io/llms.txt
Use this file to discover all available pages before exploring further.
Agent Setup
The Datadog agent can be configured to forward data to Bronto in addition to Datadog.
~/.datadog-agent/datadog.yaml
logs_config:
...
additional_endpoints:
- api_key: "YOUR-API-KEY"
host: "ingestion.<REGION>.bronto.io"
port: 443
is_reliable: true
By default, Bronto datasets and collections where data is sent are based respectively on the service and source
tags reported by the datadog agent. These can be overwritten with the br_dataset and br_collection attributes
if required.Configuration changes can be performed by upgrading the Datadog agent Helm chart, e.g.helm upgrade datadog-agent -f datadog-values.yaml datadog/datadog
datadog:
...
podAnnotationsAsTags:
kubernetes.annotations.logs.bronto.io/collection: br_collection
...
logs:
enabled: true
...
agents:
...
customAgentConfig:
logs_config:
...
additional_endpoints:
- api_key: "<BRONTO_API_KEY>"
Host: "ingestion.<REGION>.bronto.io"
Port: 443
is_reliable: true
Adding the kubernetes.annotations.logs.bronto.io/collection annotation to pods from which logs should be forwarded to Bronto is recommended.
Setting its value to a unique identifier for the cluster is also recommended, e.g. <CLUSTER_NAME>-<ENVIRONMENT>-<REGION>. FinallypodAnnotationsAsTags:
kubernetes.annotations.logs.bronto.io/collection: br_collection
indicates that the value of the kubernetes.annotations.logs.bronto.io/collection annotation should be assigned to the br_collection log attribute.
This attribute is used by Bronto in order to determine the name of the collection where to save the log data under.
| Parameter | Value | Requirement | Description |
|---|
| inputs | api_key | Required | Your Bronto API key |
| host | ingestion.<REGION>.bronto.io | Required | The Bronto endpoint responsible for ingesting log data. Supported regions are EU & US |
| port | 443 | Required | The Bronto endpoint port responsible for ingesting log data. |
| is_reliable | true | Optional | Treat the Bronto endpoint with the same priority as the primary endpoint. This is to ensure that data is not missed if the primary destination becomes unavailable. |
Verify Log Collection
Once you have applied your configuration and restarted the datadog agent, you can expect to see your log data being ingested to Bronto and accessible via the Search page.