Si sus log datos ya están siendo monitoreados por Heroku el enrutador Logplex integrado, puede usar nuestra integración para reenviar y enriquecer sus datos en New Relic.
Reenviar su registro Heroku a New Relic le brindará capacidades mejoradas para recopilar, procesar, explorar, consultar y alertar sobre sus datos log .
Actualmente admitimos drenajes Heroku HTTPS y drenajes Heroku Syslog.
Al utilizar los drenajes HTTPS Heroku , podrá agregar metadatos personalizados a su registro. De esa manera, puedes configurar un atributo diferente para cada uno de tus desagües, como el nombre de la aplicación o cualquier otro atributo que puedas necesitar. Además, todo el proceso de registrar nuevos drenajes y eliminarlos es más sencillo que con syslog.
Los drenajes Heroku Syslog en la contraparte no le permiten agregar estos metadatos personalizados, por lo que es más difícil diferenciar entre los drenajes configurados en el registro.
Drenajes HTTPS de Heroku
Para configurar este tipo de drenaje:
Asegúrese de tener el rol de administrador.
Vaya al mercado New Relic .
En
Logging
, haga clic en el mosaico
Heroku
. También puedes buscarlo usando la barra de búsqueda.Si tiene varias cuentas, seleccione la cuenta a la que desea enviar el registro.
Opcional: haga clic en
Add metadata
si desea agregar metadatos personalizados al drenaje log y completar la lista con los pares de claves que necesita.
Haga clic en
Generate URL
. Se generará una URL sin encabezado y se mostrará junto con el comando CLI de Heroku para configurar el token de drenaje.
Copie el comando CLI de Heroku a su portapapeles haciendo clic en el botón
Copy to clipboard
.
Vaya a su terminal en el directorio donde tiene configurada la CLI de Heroku.
Pegue el comando y reemplace
{{YOUR_APP_NAME}}
con el nombre de su aplicación Heroku.Opcional: haga clic en
Test for logs
si desea comprobar si los registros llegan New Relic.
Drenajes de Heroku Syslog
Le sugerimos que utilice drenajes HTTPSHeroku siempre que sea posible, ya que son fáciles de instalar y eliminar y también permiten agregar atributos personalizados a su registro.
Crear un drenaje Heroku Syslog
Le recomendamos que utilice drenajes HTTPS Heroku porque son fáciles de configurar y porque le permiten agregar atributos a su registro. Pero si necesita utilizar un drenaje syslog, este es el procedimiento:
Asegúrese de tener el rol de administrador.
Descargue e instale la CLI de Heroku.
Utilice la CLI Heroku para crear un drenaje Syslog y adjuntarlo a la aplicación desde la que desea transmitir el registro, reemplazando
YOUR_APP_NAME
con el nombre de su aplicación Heroku .bash$heroku drains:add syslog+tls://newrelic.syslog.nr-data.net:6515 -a YOUR_APP_NAMESi se encuentra en Europa, ejecute este comando en su lugar:
bash$heroku drains:add syslog+tls://newrelic.syslog.eu.nr-data.net:6515 -a YOUR_APP_NAMEEjecute el siguiente comando y copie el token de drenaje Heroku Syslog del atributo
token
:bash$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"}
Registre un drenaje de syslog de Heroku
A continuación, deberá registrar su drenaje Heroku Syslog recién creado en New Relic:
Asegúrese de tener el rol de administrador.
Vaya al mercado New Relic .
En
Logging
, haga clic en el mosaico
Heroku (syslog)
. También puedes buscarlo usando la barra de búsqueda.Si tiene varias cuentas, seleccione la cuenta en la que desea registrar el token de drenaje.
Pegue su token de drenaje Heroku recién creado en el campo
Heroku drain token
.
Haga clic en
Add Heroku drain log
para completar el registro.
Importante
Actualmente Heroku no admite la personalización del formato del registro enviado desde Logplex. Para obtener más información, consulte la documentación sobre el formato de registro de Heroku.
¿Te ha ayudado este documento con la instalación?
Eliminar un Heroku token mapeo de drenaje de syslog
Puede eliminar el Heroku mapeo de drenaje de syslog token a través de la New Relic UI o mediante API.
Para eliminar un Heroku mapeo de drenaje de syslog token a través de la UI:
Asegúrese de tener el rol de administrador.
Vaya al mercado New Relic .
En
Logging
, haga clic en el mosaico
Heroku (syslog)
. También puedes buscarlo usando la barra de búsqueda.Si tiene varias cuentas, seleccione la cuenta que contiene el mapeo token drenaje que desea eliminar y haga clic en
Continue
. De lo contrario, vaya al paso 6.
Busque el mapeo del token de drenaje que desea eliminar y haga clic en el ícono vertical de tres puntos que se encuentra al lado. A continuación, haga clic en
Delete Heroku drain token
.
Se elimina el mapeo de su token de drenaje de Heroku.
Para eliminar un Heroku mapeo de drenaje de syslog token a través de REST:API
Busque o genere un
.
Ejecute el siguiente comando para recuperar una lista de mapeo de Heroku drenaje token de su New Relic cuenta , asegurándose de actualizar los valores de YOUR_NR_LICENSE_KEY y 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
El resultado formateado se parece a esto:
[ { "herokuMappingId": 1549, "drainToken": "YOUR_DRAIN_TOKEN", "nrApiInsertKey": "YOUR_DRAIN_TOKEN_NR_API_KEY", "createdAt": "2022-05-13T07:47:23", "createdBy": "YOUR_EMAIL_ADDRESS" }]
Necesita el herokuMappingId
para cada token de drenaje que desee eliminar.
Para eliminar un token de drenaje, ejecute el siguiente comando. Asegúrate de actualizar los valores de
YOUR_NR_LICENSE_KEY
(/docs/apis/intro-apis/New Relic-clave de API/#clave de licencia),YOUR_NR_ACCOUNT_ID
(/docs/accounts/accounts-billing/account-structure/account -id/), y elherokuMappingId
que recuperaste en el último paso:bash$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
Cuando haya terminado, la API devuelve una respuesta HTTP 204 y se elimina el mapeo token de drenaje.
Ver datos log
Si todo está configurado correctamente y se están recopilando sus datos, debería ver el registro de datos en ambos lugares:
- Nuestra UIusuario de registro
- New Relic para ejecutar consultaNRQL . Por ejemplo, puedes ejecutar una consulta como esta:
SELECT * FROM Log
Si no aparecen datos después de habilitar nuestras capacidades de administración de registros, siga nuestros procedimientos estándar de resolución de problemas de registros.
¿Que sigue?
- Explore los datos de registro en su plataforma con nuestra UIde registro.
- Obtenga una visibilidad más profunda de los datos de rendimiento de su aplicación y de su plataforma reenviando su registro con nuestras capacidades de logs en el contexto .
- Configurar alerta.
- Consulta tus datos y crea un panel.
Desactivar reenvío de registros
Para deshabilitar las capacidades de reenvío de registros, siga los procedimientos estándar en la documentación Heroku Syslog. No necesitas hacer nada más en New Relic.