Envie logs para o Datadog

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.

Última atualização

Ver como Markdown Configurar agente

Você pode enviar os logs de um stream para o Datadog pelo Azion Console ou com a Azion API.

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.

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.
  • Um workload 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.

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.

Envie uma requisição POST para https://api.azion.com/v4/workspace/stream/streams. No corpo, substitua <workload-id> 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:

Shell
01curl -X POST 'https://api.azion.com/v4/workspace/stream/streams' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -d {
05 "name": "logs-to-datadog",
06 "active": true,
07 "inputs": [
08 { "type": "raw_logs", "attributes": { "data_source": "workloads" } }
09 ],
10 "transform": [
11 { "type": "filter_workloads", "attributes": { "workloads": [<workload-id>] } },
12 { "type": "render_template", "attributes": { "template": 2 } }
13 ],
14 "outputs": [
15 {
16 "type": "datadog",
17 "attributes": {
18 "url": "https://http-intake.logs.datadoghq.com/v1/input",
19 "api_key": "[API KEY]"
20 }
21 }
22 ]
23 }

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
01{
02 "state": "executed",
03 "data": {
04 "id": 12354,
05 "name": "logs-to-datadog",
06 "last_editor": "user@example.com",
07 "created": "2026-01-01T12:10:37.000000Z",
08 "last_modified": "2026-01-01T12:10:37.000000Z",
09 "product_version": "1.0",
10 …
11 "outputs": [
12 {
13 "type": "datadog",
14 "attributes": {
15 "url": "https://http-intake.logs.datadoghq.com/v1/input",
16 "api_key": "[API KEY]"
17 }
18 }
19 ]
20 }
21}

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.

Para criar o stream no Azion Console:

Abra o Data Stream

Acesse Azion Console > Data Stream.

Selecione + Stream
Dê um nome ao stream

Na seção General, informe um Name. Por exemplo: logs-to-datadog.

Selecione a fonte de dados

Na seção Input, selecione Applications em Data Source.

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.

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.

Selecione o template

Na seção Render Template, selecione Applications Event Collector em Template.

Selecione o endpoint Datadog

Na seção Output, selecione Datadog em Connector.

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.

Informe a API key

Em API Key, informe sua API key do Datadog.

Mantenha o stream ativo

Na seção Status, mantenha Active ativado.

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.

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 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.

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:

Shell
01curl -X POST 'https://api.azion.com/v4/events/graphql' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -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
01{
02 "data": {
03 "dataStreamedEvents": [
04 {
05 "ts": "2026-01-01T12:02:04Z",
06 "endpointType": "DATADOG",
07 "statusCode": 200,
08 "streamedLines": 2,
09 "dataStreamed": 2797
10 }
11 ]
12 }
13}

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.

Para encontrar os envios no Azion Console:

Abra o Real-Time Events

Acesse Azion Console > Real-Time Events.

Selecione a fonte de dados Data Stream
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.

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.

Próximos passos

EndpointsTodos os campos do endpoint Datadog, com tipo, limites e nome na API.Templates e payloadEscolha as variáveis que cada linha de log leva ao Datadog.Edite, pare ou exclua um streamTroque a API key ou a URL de intake, desative o stream ou exclua-o.Solucionar problemas de Data StreamDescubra o que um status diferente de 200 significa e como corrigir o stream.