Log de fluxo do Heroku

Se seus log dados já estão sendo monitorados Heroku pelo roteador Logplexintegrado, você pode usar nossa integração para encaminhar e enriquecer seus dados no New Relic.

Encaminhar seu registro Heroku para New Relic proporcionará gerenciamento de logsrecursos aprimorados para coletar, processar, explorar, consultar e alertar sobre seus dados log .

Atualmente, oferecemos suporte a drenos Heroku HTTPS e drenos Heroku Syslog.

Usando os drenos HTTPS Heroku você poderá adicionar metadados personalizados ao seu log. Dessa forma, você pode definir atributos diferentes para cada um dos seus drenos, como o nome do aplicativo ou qualquer outro atributo que precisar. Além disso, todo o processo de registro de novos drenos e exclusão deles é mais fácil do que com o syslog.

Os drenos Heroku Syslog na contraparte não permitem que você adicione esses metadados personalizados, portanto é mais difícil diferenciar os drenos configurados no log.

Drenos Heroku HTTPS

Para configurar este tipo de dreno:

1. Certifique-se de ter a função de administrador.

2. Vá para o Mercado New Relic .

3. Em

   Logging

   , clique no bloco Heroku . Você também pode pesquisá-lo usando a barra de pesquisa.

4. Se você tiver várias contas, selecione a conta para a qual deseja enviar o log.

5. Opcional: clique em

   Add metadata

   se desejar adicionar metadados personalizados à drenagem de log e preencher a lista com os pares de chaves necessários.

6. Clique em

   Generate URL

   . Um URL sem cabeçalho será gerado e mostrado junto com o comando Heroku CLI para configurar o token de drenagem.

7. Copie o comando Heroku CLI para sua área de transferência clicando no botão

   Copy to clipboard

   .

8. Vá para o seu terminal no diretório onde você configurou o Heroku CLI.

9. Cole o comando e substitua {{YOUR_APP_NAME}} pelo nome do seu aplicativo Heroku.

10. Opcional: clique em

    Test for logs

    se quiser verificar se o log está chegando New Relic.

Drenos de Syslog do Heroku

Sugerimos que você utilize drenosHeroku HTTPS sempre que possível, pois são simples de instalar, remover e também permitem adicionar atributo personalizado ao seu log.

Crie um dreno Heroku Syslog

Recomendamos que você use drenos Heroku HTTPS porque eles são simples de configurar e permitem adicionar atributos ao seu log. Mas se você precisar usar um dreno de syslog, aqui está o procedimento:

1. Certifique-se de ter a função de administrador.

2. Baixe e instale a CLI do Heroku.

3. Use a CLI Heroku para criar um dreno de Syslog e anexe-o ao aplicativo do qual você deseja transmitir o log, substituindo YOUR_APP_NAME pelo nome do seu aplicativo Heroku .

   bash

   Copiar

   $
   heroku drains:add syslog+tls://newrelic.syslog.nr-data.net:6515 -a YOUR_APP_NAME

   Se você estiver na Europa, execute este comando:

   bash

   Copiar

   $
   heroku drains:add syslog+tls://newrelic.syslog.eu.nr-data.net:6515 -a YOUR_APP_NAME

4. Execute o seguinte comando e copie o token de drenagem do Syslog do Heroku do atributo token :

   bash

   Copiar

   $
   heroku drains -a YOUR_APP_NAME --json

   {
     "addon": null,
     "created_at": "2018-12-04T00:59:46Z",
     "id": "906262a4-e151-45d2-b35a-a2dc0ea9e688",
     "token": "d.f14da5dc-106b-468d-b1bd-bed0ed9fa1e7",
     "updated_at": "2018-12-04T00:59:47Z",
     "url": "syslog+tls://newrelic.syslog.nr-data.net:6515"
   }

   Copiar

Registre um dreno de syslog do Heroku

Em seguida, você precisará registrar seu dreno Heroku Syslog recém-criado no New Relic:

1. Certifique-se de ter a função de administrador.

2. Vá para o Mercado New Relic .

3. Em

   Logging

   , clique no bloco Heroku (syslog) . Você também pode pesquisá-lo usando a barra de pesquisa.

4. Se você tiver várias contas, selecione a conta na qual deseja registrar o token de drenagem.

5. Cole seu token de drenagem Heroku recém-criado no campo

   Heroku drain token

   .

6. Clique em

   Add Heroku drain log

   para concluir o registro.

Excluir um mapeamento de token de drenagem de syslog do Heroku

Você pode excluir o mapeamento do token de drenagem do syslog do Heroku por meio da interface do usuário do New Relic ou da API.

Para excluir um Heroku mapeamento de drenagem do syslog token por meio da interface:

1. Certifique-se de ter a função de administrador.

2. Vá para o Mercado New Relic .

3. Em

   Logging

   , clique no bloco Heroku (syslog) . Você também pode pesquisá-lo usando a barra de pesquisa.

4. Se você tiver diversas contas, selecione a conta que contém o mapeamento token drenagem que deseja excluir e clique em

   Continue

   . Caso contrário, vá para a etapa 6.

5. Encontre o mapeamento do token de drenagem que deseja excluir e clique no ícone vertical de três pontos próximo a ele. Em seguida, clique em

   Delete Heroku drain token

   .

6. O mapeamento do token de drenagem do Heroku foi excluído.

Para excluir um mapeamento de token de drenagem de syslog Heroku via API REST:

1. Encontre ou gere um

   chave de usuário

   .

2. Execute o comando abaixo para recuperar uma lista de Heroku token mapeamento drenagem de sua New Relic conta , certificando-se de atualizar os valores para YOUR_NR_LICENSE_KEY e YOUR_NR_ACCOUNT_ID:

$
curl -H 'api-key: YOUR_NR_LICENSE_KEY' https://log-syslog-configuration-api.service.newrelic.com/heroku-account-mappings?accountId=YOUR_NR_ACCOUNT_ID

O resultado formatado é mais ou menos assim:

[
  {
    "herokuMappingId": 1549,
    "drainToken": "YOUR_DRAIN_TOKEN",
    "nrApiInsertKey": "YOUR_DRAIN_TOKEN_NR_API_KEY",
    "createdAt": "2022-05-13T07:47:23",
    "createdBy": "YOUR_EMAIL_ADDRESS"
  }
]

Você precisa do herokuMappingId para cada token de drenagem que deseja remover.

3. Para excluir um token de drenagem, execute o comando abaixo. Certifique-se de atualizar os valores de YOUR_NR_LICENSE_KEY(/docs/apis/intro-apis/New Relic-chave de API/#chave de licença),YOUR_NR_ACCOUNT_ID(/docs/accounts/accounts-billing/account-structure/account -id/) e o herokuMappingId que você recuperou na última etapa:

   bash

   Copiar

   $
   curl -XDELETE -H 'api-key: YOUR_NR_LICENSE_KEY' https://log-syslog-configuration-api.service.newrelic.com/heroku-account-mappings/<herokuMappingId>?accountId=YOUR_NR_ACCOUNT_ID

Quando terminar, a API retornará uma resposta HTTP 204 e o mapeamento do token de drenagem será excluído.

Ver dados log

Se tudo estiver configurado corretamente e seus dados estiverem sendo coletados, você deverá ver o registro de dados em ambos os locais:

• Nossa interface de registro
• New Relic para execução de consultaNRQL . Por exemplo, você pode executar uma consulta como esta:

SELECT * FROM Log

Se nenhum dado aparecer após você ativar nossos recursos de gerenciamento de logs, siga nossos procedimentos padrão de resolução de problemas de log.

Qual é o próximo?

• Explore os dados de registro em sua plataforma com nossa interface de registro.
• Obtenha visibilidade mais profunda dos dados de desempenho do seu aplicativo e da sua plataforma encaminhando seu log com nossos recursos logs contextualizados .
• Configure o alerta.
• consulte seus dados e crie dashboard.

Desativar encaminhamento de logs

Para desativar os recursos de encaminhamento de logs, siga os procedimentos padrão na documentação Heroku Syslog. Você não precisa fazer mais nada no New Relic.