--- name: azion-envie-logs-para-o-datadog description: >- Crie um stream que envia os logs das suas aplicações para a URL de intake de logs do Datadog, no Azion Console ou com a Azion API, e confirme a entrega. --- # Envie logs para o Datadog Você pode enviar os logs de um stream para o [Datadog](https://www.datadoghq.com/) pelo Azion Console ou com a Azion API. [Data Stream](/pt-br/documentacao/plataforma/data-stream/) envia cada lote de linhas de log para a URL de intake de logs da sua conta do Datadog e se autentica com uma API key do Datadog. No formulário do stream, o endpoint é definido no campo **Connector**, e o Datadog é a opção *Datadog* desse campo. Para ver todos os campos e os limites deles, consulte [Endpoints](/pt-br/documentacao/plataforma/data-stream/endpoints/#datadog). Neste guia, o stream coleta as requisições que um workload recebe, por meio da fonte de dados *Applications*. --- Selecione Console ou API aqui. Todas as seções da página seguem essa escolha. ## Pré-requisitos - Uma conta Azion com a permissão **Edit Data Stream**. Para ver as permissões, consulte [Configurações do stream](/pt-br/documentacao/plataforma/data-stream/configuracoes-do-stream/#permissoes). - Um [workload](/pt-br/documentacao/plataforma/workloads/) na conta que recebe requisições. - Uma conta do Datadog. - A URL de intake de logs da sua conta do Datadog, com o esquema, como `https://http-intake.logs.datadoghq.com/v1/input`. - Uma API key do Datadog, criada no dashboard do Datadog. **Console** - Acesso ao Azion Console. Para entrar, consulte [Acessar Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/). **API** - Um personal token. Para criar um, consulte [Gerenciar um personal token](/pt-br/documentacao/guias/plataforma/conta-e-billing/personal-tokens/). - O ID do workload. - `curl`. --- ## Crie o stream Um filtro de workloads limita o stream ao workload que você escolher. Ao contrário de um stream com sampling, um stream com filtro de workloads mantém seus outros streams ativos. **Console** Para criar o stream no Azion Console: 1. **Abra o Data Stream** Acesse [Azion Console](https://console.azion.com/) > **Data Stream**. 2. **Selecione + Stream** 3. **Dê um nome ao stream** Na seção **General**, informe um **Name**. Por exemplo: `logs-to-datadog`. 4. **Selecione a fonte de dados** Na seção **Input**, selecione *Applications* em **Data Source**. 5. **Desative o Sampling** Na seção **Transform**, desative **Sampling** enquanto **Option** ainda estiver em *All Current and Future Workloads*, o valor inicial. Um stream não pode ter sampling e filtro de workloads ao mesmo tempo. 6. **Escolha o workload** Na seção **Transform**, defina **Option** como *Filter Workloads*. Em **Available Workload**, selecione seu workload e mova-o para **Chosen Workload** com a seta. 7. **Selecione o template** Na seção **Render Template**, selecione *Applications Event Collector* em **Template**. 8. **Selecione o endpoint Datadog** Na seção **Output**, selecione *Datadog* em **Connector**. 9. **Informe a URL de intake** Em **URL**, informe a URL de intake de logs da sua conta do Datadog. Por exemplo: `https://http-intake.logs.datadoghq.com/v1/input`. 10. **Informe a API key** Em **API Key**, informe sua API key do Datadog. 11. **Mantenha o stream ativo** Na seção **Status**, mantenha **Active** ativado. 12. **Selecione Save** O Console mostra `Your data stream has been created`. O stream aparece na lista do **Data Stream** com `Datadog` na coluna **Connector** e o status **Active**. **API** Envie uma requisição `POST` para `https://api.azion.com/v4/workspace/stream/streams`. No corpo, substitua `` pelo ID do seu workload e informe sua URL de intake e sua API key na entrada de `outputs`. Substitua `[TOKEN VALUE]` pelo seu personal token: ```bash curl -X POST 'https://api.azion.com/v4/workspace/stream/streams' \ -H 'Content-Type: application/json' \ -H 'Authorization: Token [TOKEN VALUE]' \ -d '{ "name": "logs-to-datadog", "active": true, "inputs": [ { "type": "raw_logs", "attributes": { "data_source": "workloads" } } ], "transform": [ { "type": "filter_workloads", "attributes": { "workloads": [] } }, { "type": "render_template", "attributes": { "template": 2 } } ], "outputs": [ { "type": "datadog", "attributes": { "url": "https://http-intake.logs.datadoghq.com/v1/input", "api_key": "[API KEY]" } } ] }' ``` No corpo, `workloads` é o nome na API da fonte de dados *Applications*, e o template `2` é *Applications Event Collector*. Uma resposta `201` retorna o stream como a Azion o armazenou: ```json { "state": "executed", "data": { "id": 12354, "name": "logs-to-datadog", "last_editor": "user@example.com", "created": "2026-01-01T12:10:37.000000Z", "last_modified": "2026-01-01T12:10:37.000000Z", "product_version": "1.0", … "outputs": [ { "type": "datadog", "attributes": { "url": "https://http-intake.logs.datadoghq.com/v1/input", "api_key": "[API KEY]" } } ] } } ``` O `id` identifica o stream em todas as requisições seguintes, como `/v4/workspace/stream/streams/12354`. Para ver todas as chaves do corpo, consulte [Configurações do stream](/pt-br/documentacao/plataforma/data-stream/configuracoes-do-stream/#objeto-do-stream). Nem o Console nem a API contatam o Datadog quando você salva. Uma URL digitada errada ou uma API key inválida só aparece como um envio com falha. O stream começa a enviar de um a dois minutos depois de você ativá-lo. --- ## Confirme a entrega Cada tentativa do stream de enviar um lote, com sucesso ou não, aparece no [Real-Time Events](/pt-br/documentacao/plataforma/real-time-events/fontes-de-dados/#data-stream) com o status code que o Datadog retornou. Envie algumas requisições ao workload e espere cerca de um minuto. O stream envia um lote a cada 60 segundos, ou antes, quando o lote chega a 2.000 linhas de log. **Console** Para encontrar os envios no Azion Console: 1. **Abra o Real-Time Events** Acesse [Azion Console](https://console.azion.com/) > **Real-Time Events**. 2. **Selecione a fonte de dados Data Stream** 3. **Leia os envios mais recentes** Cada linha é um envio. Encontre as linhas com `DATADOG` em **Endpoint Type** e leia o **Status Code** delas. Um **Status Code** `200` significa que o Datadog aceitou o lote. **Streamed Lines** mostra o número de linhas de log do lote. **API** Para ler os envios com a API, consulte o dataset `dataStreamedEvents` da API GraphQL do Real-Time Events. Substitua as datas por um intervalo que cubra a ativação do stream: ```bash curl -X POST 'https://api.azion.com/v4/events/graphql' \ -H 'Content-Type: application/json' \ -H 'Authorization: Token [TOKEN VALUE]' \ -d '{"query":"query { dataStreamedEvents(limit: 20, filter: {tsRange: {begin: \"2026-01-01T12:00:00\", end: \"2026-01-01T12:45:00\"}}, orderBy: [ts_DESC]) { ts endpointType statusCode streamedLines dataStreamed } }"}' ``` A API responde `200` com um registro para cada envio, do mais recente para o mais antigo: ```json { "data": { "dataStreamedEvents": [ { "ts": "2026-01-01T12:02:04Z", "endpointType": "DATADOG", "statusCode": 200, "streamedLines": 2, "dataStreamed": 2797 } ] } } ``` Um envio para o Datadog traz `DATADOG` em `endpointType`. Um `statusCode` `200` significa que o Datadog aceitou o lote, e `streamedLines` e `dataStreamed` dão o tamanho dele em linhas de log e em bytes. Uma lista `dataStreamedEvents` vazia significa que o stream não enviou nada no intervalo. Para ver todos os campos, consulte [Campos da API GraphQL do Real-Time Events](/pt-br/documentacao/devtools/graphql/campos-gql-real-time-events/#datastreamedevents-data-stream). Qualquer status diferente de `200` é a resposta do Datadog, exceto `503`, que significa que Data Stream encontrou o endpoint indisponível. Para ver as causas, consulte [Solucionar problemas de Data Stream](/pt-br/documentacao/plataforma/data-stream/solucao-de-problemas/). --- ## Próximos passos - [Endpoints](/pt-br/documentacao/plataforma/data-stream/endpoints.md#datadog): Todos os campos do endpoint Datadog, com tipo, limites e nome na API. - [Templates e payload](/pt-br/documentacao/plataforma/data-stream/templates-e-payload.md): Escolha as variáveis que cada linha de log leva ao Datadog. - [Edite, pare ou exclua um stream](/pt-br/documentacao/guias/plataforma/observabilidade/deletar-data-stream.md): Troque a API key ou a URL de intake, desative o stream ou exclua-o. - [Solucionar problemas de Data Stream](/pt-br/documentacao/plataforma/data-stream/solucao-de-problemas.md): Descubra o que um status diferente de 200 significa e como corrigir o stream.