Log de diffusion de Heroku

Si vos log données sont déjà monitorées par Heroku le routeur Logplex intégré de , vous pouvez utiliser notre intégration pour transférer et enrichir vos log données dans New Relic.

La transmission de votre Heroku log vers New Relic vous offrira des gestion des logscapacités améliorées pour collecter, traiter, explorer, interroger et alerter sur vos log données .

Nous prenons actuellement en charge les drains HTTPS Heroku et les drains Syslog Heroku.

En utilisant les drains HTTPS Heroku , vous pourrez ajouter des métadonnées personnalisées à votre log. De cette façon, vous pouvez définir un attribut différent pour chacun de vos drains, comme le nom de l'application ou tout autre attribut dont vous pourriez avoir besoin. De plus, l'ensemble du processus d'enregistrement de nouveaux drains et de leur suppression est plus simple qu'avec syslog.

Les drains Heroku Syslog sur la contrepartie ne vous permettent pas d'ajouter cette métadonnées personnalisée, il est donc plus difficile de différencier les drains configurés sur le log.

Heroku HTTPS draine

Pour configurer ce type de drain :

1. Assurez-vous d'avoir le rôle d'administrateur.
2. Allez au New Relic Marketplace.
3. Sous Logging, cliquez sur la tuile Heroku . Vous pouvez également le rechercher en utilisant la barre de recherche.
4. Si vous avez plusieurs comptes, sélectionnez le compte vers lequel vous souhaitez envoyer le log.
5. Facultatif : cliquez sur Add metadata si vous souhaitez ajouter des métadonnées personnalisées au drain log et remplir la liste avec les paires de clés dont vous avez besoin.
6. Donnez un nom à votre application. Vous l'utiliserez pour retrouver vos données plus tard.
7. Copiez la commande Heroku CLI dans votre presse-papiers en cliquant sur le bouton Copy to clipboard .
8. Accédez à votre terminal dans le répertoire où vous avez configuré la CLI Heroku. Si vous utilisez une machine virtuelle Windows, utilisez l’invite de commande traditionnelle au lieu de Git Bash.
9. Exécutez la commande dans votre terminal.
10. Facultatif : cliquez sur Test for logs si vous souhaitez vérifier si les logs atteignent New Relic.

Drains Syslog Heroku

Nous vous suggérons d'utiliser les drains HTTPSHeroku autant que possible car ils sont simples à installer, à supprimer et permettent également d'ajouter des attributs personnalisés à votre log.

Créer un drain Heroku Syslog

Nous vous recommandons d'utiliser les drains HTTPS Heroku car ils sont simples à configurer et parce qu'ils vous permettent d'ajouter un attribut à votre log. Mais si vous devez utiliser un drain syslog, voici la procédure :

1. Assurez-vous d'avoir le rôle d'administrateur.

2. Téléchargez et installez Heroku CLI.

3. Utilisez l'interface de ligne de commande Heroku pour créer un drain Syslog et l'attacher à l'application à partir de laquelle vous souhaitez diffuser le log, en remplaçant YOUR_APP_NAME par le nom de votre application Heroku .

   bash

   Copier

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

   Si vous êtes situé en Europe, exécutez plutôt cette commande :

   bash

   Copier

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

4. Exécutez la commande suivante et copiez le jeton de drainage Heroku Syslog à partir de l'attribut token :

   bash

   Copier

   $
   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"
   }

   Copier

Enregistrer un drain syslog Heroku

Ensuite, vous devrez enregistrer votre drain Heroku Syslog nouvellement créé dans New Relic :

1. Assurez-vous d'avoir le rôle d'administrateur.
2. Allez au New Relic Marketplace.
3. Sous Logging, cliquez sur la tuile Heroku (syslog) . Vous pouvez également le rechercher en utilisant la barre de recherche.
4. Si vous avez plusieurs comptes, sélectionnez le compte dans lequel vous souhaitez enregistrer le jeton de drainage.
5. Collez votre jeton de drainage Heroku nouvellement créé dans le champ Heroku drain token .
6. Cliquez sur Add Heroku drain log pour terminer l'inscription.

Supprimer une modélisation Jeton de drain Heroku syslog

Vous pouvez supprimer Heroku syslog le jet de drainage via l'interface utilisateur de New Relic ou via l'API.

Pour supprimer une Heroku syslog modélisation de jeton de drain via l'interface utilisateur :

1. Assurez-vous d'avoir le rôle d'administrateur.
2. Allez au New Relic Marketplace.
3. Sous Logging, cliquez sur la tuile Heroku (syslog) . Vous pouvez également le rechercher en utilisant la barre de recherche.
4. Si vous avez plusieurs comptes, sélectionnez le compte qui contient la modélisation de jeton de vidange que vous souhaitez supprimer et cliquez sur Continue. Sinon, passez à l’étape 6.
5. Recherchez la modélisation du jeton de vidange que vous souhaitez supprimer et cliquez sur l’icône verticale à trois points à côté. Ensuite, cliquez sur Delete Heroku drain token.
6. Votre modélisation de jeton de vidange Heroku est supprimée.

Pour supprimer un Heroku syslog jet de drainage via la modélisation API REST :

1. Rechercher ou générer un clé d'utilisateur.

2. Exécutez la commande ci-dessous pour récupérer une liste de modélisation de jeton de drainage Heroku à partir de votre compte New Relic, en veillant à mettre à jour les valeurs pour YOUR_NR_LICENSE_KEY et YOUR_NR_ACCOUNT_ID:

   bash

   Copier

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

   Le résultat formaté ressemble à ceci :

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

   Copier

   Vous avez besoin du herokuMappingId pour chaque jeton de drainage que vous souhaitez supprimer.

3. Pour supprimer un jeton de drainage, exécutez la commande ci-dessous. Assurez-vous de mettre à jour les valeurs de YOUR_NR_LICENSE_KEY, YOUR_NR_ACCOUNT_ID et herokuMappingId que vous avez récupérées à l'étape précédente :

   bash

   Copier

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

Une fois terminé, l'API renvoie une réponse HTTP 204 et la modélisation du jet de drainage est supprimée.

Afficher les données log

Si tout est configuré correctement et que vos données sont collectées, vous devriez voir le log des données à ces deux endroits :

• Notre UI de log
• Nouveaux outils Relic pour l'exécution de requêtes NRQL . Par exemple, vous pouvez exécuter une requête comme celle-ci :

SELECT * FROM Log

Si aucune donnée n'apparaît après avoir activé nos fonctionnalités de gestion des log , suivez nos procédures standard de dépannage log .

Quelle est la prochaine étape ?

• Explorez les données de logging sur votre plateforme avec notre interface utilisateur de logs.
• Obtenez une visibilité plus approfondie sur les données de performances de votre application et de votre plateforme en transmettant votre log avec nos capacités de logs en contexte .
• Configurer des alertes.
• interrogez vos données et créez un dashboard.

Désactiver le transfert de log

Pour désactiver les fonctionnalités de transfert de log , suivez les procédures standard dans la documentationHeroku Syslog. Vous n'avez rien d'autre à faire dans New Relic.