# Datadog

The Datadog output plugin allows to ingest your logs into [Datadog](https://app.datadoghq.com/signup).

Before you begin, you need a [Datadog account](https://app.datadoghq.com/signup), a [Datadog API key](https://docs.datadoghq.com/account_management/api-app-keys/), and you need to [activate Datadog Logs Management](https://app.datadoghq.com/logs/activation).

## Configuration Parameters

| Key         | Description                                                                                                              | Default                          |
| ----------- | ------------------------------------------------------------------------------------------------------------------------ | -------------------------------- |
| Host        | *Required* - The Datadog server where you are sending your logs.                                                         | `http-intake.logs.datadoghq.com` |
| TLS         | *Required* - End-to-end security communications security protocol. Datadog recommends leaving this `on`.                 | `on`                             |
| apikey      | *Required* - Your [Datadog API key](https://app.datadoghq.com/account/settings#api).                                     |                                  |
| dd\_service | *Recommended* - The human readable name for your service generating the logs - the name of your application or database. |                                  |
| dd\_source  | *Recommended* - A human readable name for the underlying technology of your service. For example, `postgres` or `nginx`. |                                  |
| dd\_tags    | *Optional* - The [tags](https://docs.datadoghq.com/tagging/) you want to assign to your logs in Datadog.                 |                                  |

### Configuration File

Get started quickly with this configuration file:

```
[OUTPUT]
    Name        datadog
    Match       *
    Host        http-intake.logs.datadoghq.com
    TLS         on
    apikey      <my-datadog-api-key>
    dd_service  <my-app-service>
    dd_source   <my-app-source>
    dd_tags     team:logs,foo:bar
```

## Troubleshooting

### 403 Forbidden

If you get a `403 Forbidden` error response, double check that you have a valid [Datadog API key](https://docs.datadoghq.com/account_management/api-app-keys/) and that you have [activated Datadog Logs Management](https://app.datadoghq.com/logs/activation).