Plugin Logstash pour le transfert de log

Si vos données log sont déjà monitorées par Logstash, vous pouvez utiliser notre plugin Logstash pour transférer et enrichir vos données log dans New Relic.

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

Activer Logstash pour la gestion des log

Pour transférer votre log de Logstash vers New Relic :

Assurez-vous d'avoir :
- Une New Relic
- Logstash version 6.6 ou supérieure avec Java 8 ou Java 11. Utilisez la distribution officielle Oracle ou une distribution open source telle que OpenJDK.
Installez et configurez le plugin Logstash.
Facultatif : configurer un attribut de plugin supplémentaire.
Testez le plugin Logstash.
Générez du trafic et attendez quelques minutes, puis vérifiez les données de votre compte .

Installer et configurer le plugin Logstash

Pour transférer votre log vers New Relic avec notre plugin Logstash:

Entrez la commande suivante dans votre terminal ou votre interface de ligne de commande :
bash
```
$logstash-plugin install logstash-output-newrelic
```
Dans votre fichier logstash.conf , ajoutez le bloc de données suivant. Assurez-vous de remplacer le texte de l'espace réservé par votre New Relic .
```
output {
  newrelic {
    license_key => "LICENSE_KEY"
  }
}
```
Redémarrez votre instance Logstash.

Ce document vous a-t-il aidé lors de votre installation ?

Configuration optionnelle

Après avoir installé et configuré le plugin Logstash, vous pouvez utiliser l’attribut suivant pour configurer la manière dont le plugin envoie les données à New Relic. Pour plus d'informations sur l'ajout ou la configuration d'attributs, consultez nos exemples configuration Logstash dans GitHub.

Propriété	Description
`concurrent_requests`	Le nombre de threads à partir desquels effectuer requests . Défaut: `1`
`base_uri`	Le point de terminaison d'ingestion New Relic. Point de terminaison américain : `https://log-api.newrelic.com/log/v1` Point de terminaison de l'UE : `https://log-api.eu.newrelic.com/log/v1`
`max_retries`	Nombre maximal de tentatives pour réessayer d'envoyer un message. Si la valeur est `0`, aucune nouvelle tentative ne sera effectuée. Défaut: `3`

Propriété

Description

concurrent_requests

Le nombre de threads à partir desquels effectuer requests . Défaut: 1

base_uri

Le point de terminaison d'ingestion New Relic.

Point de terminaison américain : https://log-api.newrelic.com/log/v1
Point de terminaison de l'UE : https://log-api.eu.newrelic.com/log/v1

max_retries

Nombre maximal de tentatives pour réessayer d'envoyer un message. Si la valeur est 0, aucune nouvelle tentative ne sera effectuée. Défaut: 3

Testez le plugin Logstash

Pour tester si votre plugin Logstash reçoit une entrée d'un fichier de log:

Ajoutez ce qui suit à votre fichier logstash.conf :

input {
  file {
    path => "/PATH/TO/YOUR/LOG/FILE"
  }
}

Redémarrez votre instance Logstash.
Exécutez la commande suivante pour ajouter un message de test de log à votre fichier de log:
bash
```
$echo "test message" >> /PATH/TO/YOUR/LOG/FILE
```
Recherchez test message dans notre interface utilisateur des logs .

Afficher les données log

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

Notre UI de logs
Nos outils pour exécuter des 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 documentation de Logstash. Vous n'avez rien d'autre à faire dans New Relic.

Cette traduction automatique est fournie pour votre commodité.