Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

pipeline: outputs: dash0: Added Dash0 documentation #1532

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -178,6 +178,7 @@
* [Azure Log Analytics](pipeline/outputs/azure.md)
* [Azure Logs Ingestion API](pipeline/outputs/azure_logs_ingestion.md)
* [Counter](pipeline/outputs/counter.md)
* [Dash0](pipeline/outputs/dash0.md)
* [Datadog](pipeline/outputs/datadog.md)
* [Dynatrace](pipeline/outputs/dynatrace.md)
* [Elasticsearch](pipeline/outputs/elasticsearch.md)
Expand Down
1 change: 1 addition & 0 deletions administration/transport-security.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ The following **output** plugins can take advantage of the TLS feature:
* [Azure Data Explorer (Kusto)](../pipeline/outputs/azure_kusto.md)
* [Azure Logs Ingestion API](../pipeline/outputs/azure_logs_ingestion.md)
* [BigQuery](../pipeline/outputs/bigquery.md)
* [Dash0](../pipeline/outputs/dash0.md)
* [Datadog](../pipeline/outputs/datadog.md)
* [Elasticsearch](../pipeline/outputs/elasticsearch.md)
* [Forward](../pipeline/outputs/forward.md)
Expand Down
63 changes: 63 additions & 0 deletions pipeline/outputs/dash0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
---
description: Send logs to Dash0
---

# Dash0

Stream logs to [Dash0](https://www.dash0.com) by utilizing the **opentelemetry** plugin to send data to the Dash0 log ingress.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Stream logs to [Dash0](https://www.dash0.com) by utilizing the **opentelemetry** plugin to send data to the Dash0 log ingress.
Stream logs to [Dash0](https://www.dash0.com) by utilizing the OpenTelemetry plugin to send data to the Dash0 log ingress.

It'd be nice to crosslink to the plugin, but not required.


## Configuration parameters

| Key | Description | Default |
| -------------------------- | ----------- | ------- |
| `header` | The specific header for bearer authorization, where {your-Auth-token-here} is your Dash0 Auth Token. | Authorization Bearer {your-Auth-token-here} |
| `host` | Your Dash0 ingress endpoint. | `ingress.eu-west-1.aws.dash0.com` |
| `port` | TCP port of your Dash0 ingress endpoint. | `443` |
| `metrics_uri` | Specify an optional HTTP URI for the target web server listening for metrics | `/v1/metrics` |
| `logs_uri` | Specify an optional HTTP URI for the target web server listening for logs | `/v1/logs` |
| `traces_uri` | Specify an optional HTTP URI for the target web server listening for traces | `/v1/traces` |

### TLS / SSL

The opentelemetry output plugin supports TLS/SSL, for more details about the properties available and general configuration, please refer to the [TLS/SSL](../../administration/transport-security.md) section.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The opentelemetry output plugin supports TLS/SSL, for more details about the properties available and general configuration, please refer to the [TLS/SSL](../../administration/transport-security.md) section.
The OpenTelemetry output plugin supports TLS/SSL. For more details about the properties available and general configuration, see [TLS/SSL](../../administration/transport-security.md).


## Getting started

To get started with sending logs to Dash0:

1. Get an [Auth Token](https://www.dash0.com/documentation/dash0/key-concepts/auth-tokens) from **Settings** > **Auth Tokens**.
1. In your main Fluent Bit configuration file, append the following `Output` section:

{% tabs %}
{% tab title="fluent-bit.conf" %}
```text
CodingFabian marked this conversation as resolved.
Show resolved Hide resolved
[OUTPUT]
Name opentelemetry
Match *
Host ingress.eu-west-1.aws.dash0.com
Port 443
Header Authorization Bearer auth_vdOxPqcvSlBkhVQV95wU9TGXh2Fdjliq
Metrics_uri /v1/metrics
Logs_uri /v1/logs
Traces_uri /v1/traces
```
{% endtab %}

{% tab title="fluent-bit.yaml" %}
```yaml
[OUTPUT]
Name: opentelemetry
CodingFabian marked this conversation as resolved.
Show resolved Hide resolved
Match: *
Host: ingress.eu-west-1.aws.dash0.com
Port: 443
Header: Authorization Bearer auth_vdOxPqcvSlBkhVQV95wU9TGXh2Fdjliq
Metrics_uri: /v1/metrics
Logs_uri: /v1/logs
Traces_uri: /v1/traces
```
{% endtab %}
{% endtabs %}
CodingFabian marked this conversation as resolved.
Show resolved Hide resolved
## References
- [Dash0 documentation](https://www.dash0.com/documentation/dash0)
1 change: 1 addition & 0 deletions vale-styles/FluentBit/Spelling-exceptions.txt
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@ coroutines
Crowdstrike
CRDs
DaemonSet
Dash0
Datadog
Datagen
datapoint
Expand Down
Loading