> For the complete documentation index, see [llms.txt](https://docs.digibee.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/settings/data-streaming/data-streaming-new-relic.md).

# Como usar a Transmissão de dados com New Relic

Aprenda a transmitir logs e dados de execução automaticamente da Digibee Integration Platform para a New Relic usando uma Ingest License Key.

## **Como a Transmissão de dados funciona com a New Relic**

A Transmissão de dados envia logs e dados de execução da Digibee Integration Platform para a New Relic automaticamente. Diferente do Splunk, que usa um Token HEC, a New Relic recebe os dados por meio do OTLP (OpenTelemetry Protocol), seu protocolo nativo de ingestão. Para autenticar os dados, a New Relic usa uma Ingest License Key, a mesma chave que qualquer agente OpenTelemetry usa para enviar dados para a sua conta.

## **Antes de começar**

Para configurar a Transmissão de dados com a New Relic, você precisa de:

* **Papel `data-streaming-manager`:** Apenas usuários com esse papel podem criar, atualizar, ler e excluir fluxos de dados. Para saber mais, leia [Papéis](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles.md).
* **Acesso a uma conta New Relic:** A conta que vai receber os dados da Digibee Integration Platform.

## **Guia passo a passo**

{% stepper %}
{% step %}

### **Criar uma Ingest License Key na New Relic**

1. Na New Relic, clique no ícone da sua conta no canto superior direito e selecione **API keys**.
2. Clique em **Create a key**.
3. Em **Type**, selecione **Ingest - License**. Não use os tipos **User** ou **Browser**. Eles têm um formato diferente e não são aceitos por esta integração.
4. Dê um nome descritivo para a chave, por exemplo `digibee-<realm>`, e confirme.
5. Copie o valor da chave no banner exibido no topo da tela. Uma Ingest License Key válida tem exatamente 40 caracteres alfanuméricos.

{% hint style="warning" %}
A New Relic exibe o valor completo da chave apenas uma vez, logo após a criação. Depois disso, a tela mostra somente uma versão mascarada, por exemplo `a2a4113f********`, e não é possível exibir ou copiar o valor novamente. Se você perder o valor, será necessário criar uma nova chave.
{% endhint %}
{% endstep %}

{% step %}

### **Configurar a Transmissão de dados na Digibee Integration Platform**

1. Na Digibee Integration Platform, clique em **Configurações** no canto superior direito da página.
2. No menu de Configurações, clique em **Transmissão de dados**.
3. Clique em **Criar**.
4. Em **Vendor**, selecione **New Relic**.
5. Em **Tipo de streaming**, selecione **Logs**, **Execuções** ou ambos.
6. Preencha os detalhes da conexão:
   * **Host:** O endpoint OTLP da região da sua conta New Relic, sem `https://`. Use `otlp.nr-data.net` para contas da região US ou `otlp.eu01.nr-data.net` para contas da região EU.
   * **Chave de API:** A Ingest License Key que você copiou no Passo 1.
7. Clique em **Salvar**.

{% hint style="info" %}
Para identificar a região da sua conta New Relic, confira o endereço que você usa para acessar a New Relic: `one.newrelic.com` indica uma conta da região US e `one.eu.newrelic.com` indica uma conta da região EU. Uma chave de licença que começa com `eu01xx` também indica uma conta da região EU.
{% endhint %}
{% endstep %}

{% step %}

### **Visualizar os dados na New Relic**

A New Relic cria automaticamente uma entidade de serviço para cada valor distinto do atributo `service.name` que recebe. Diferente do Splunk e do Datadog, a New Relic não tem um filtro manual para separar logs de execuções.

#### **Encontrar as entidades**

1. Na New Relic, acesse **APM & Services** e selecione **Services - OpenTelemetry**. Você deve ver uma entidade para cada tipo de dado recebido, por exemplo `pipeline-logs` para logs e `completed-executions` para execuções.
2. Clique em uma entidade.
3. Abra a aba **Logs** para explorar os dados.

{% hint style="info" %}
Esta integração envia apenas logs e execuções, ambos como registros de log OTLP. Ela não envia traces, por isso a aba **Distributed tracing** de cada entidade permanece vazia. Isso não indica um problema de configuração.
{% endhint %}

#### **Confirmar os dados com uma query**

Se uma entidade ainda não aparecer na lista, use NRQL (New Relic Query Language) no Query Builder para confirmar que os dados chegaram. A query a seguir conta os registros de execução recebidos na última hora:

{% code overflow="wrap" %}

```sql
FROM Log SELECT count(*) WHERE service.name = 'completed-executions' SINCE 1 hour ago
```

{% endcode %}

A New Relic só cria uma entidade depois que o primeiro registro com aquele `service.name` chega. Para execuções, pelo menos uma execução de pipeline precisa terminar no realm configurado antes que a entidade apareça.
{% endstep %}
{% endstepper %}

## **Solução de problemas**

Os dados podem levar de alguns segundos a alguns minutos para aparecer na New Relic depois que você cria o fluxo.

Se o status do fluxo na Digibee Integration Platform aparecer como `down` logo após a criação, isso é esperado. A verificação interna considera apenas a atividade dos últimos 5 minutos. Execute um pipeline e aguarde a atualização do status.

Se nenhum dado aparecer na New Relic após cerca de 10 minutos de atividade no realm, verifique primeiro a tabela `NrIntegrationError`. A New Relic pode aceitar os dados e rejeitá-los depois, de forma assíncrona. A query a seguir lista os erros de ingestão da última hora:

```sql
SELECT * FROM NrIntegrationError SINCE 1 hour ago
```

Se a causa continuar sem explicação, [entre em contato com o time de Suporte da Digibee](https://docs.digibee.com/documentation/troubleshooting/pt-br/help-and-faq/support.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/settings/data-streaming/data-streaming-new-relic.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
