Vous pouvez transférer des journaux depuis vRealize Automation vers vRealize Log Insight pour bénéficier d'une analyse de journaux et d'une génération de rapports plus robustes.
vRealize Automation est fourni avec un agent de journalisation fluentd-based. Cet agent collecte et stocke les journaux de sorte qu'ils puissent être inclus dans un bundle de journaux et examinés ultérieurement. Vous pouvez configurer l'agent pour qu'il transfère une copie des journaux vers un serveur vRealize Log Insight à l'aide de vRealize Log Insight REST API. L'API fournie permet à d'autres programmes de communiquer avec vRealize Log Insight.
Pour plus d'informations sur vRealize Log Insight, y compris la documentation de vRealize Log Insight REST API, reportez-vous à la documentation de vRealize Log Insight.
Configurez l'agent de journalisation pour qu'il transfère continuellement les journaux vRealize Automation vers vRealize Log Insight à l'aide de l'utilitaire de ligne de commande vracli fourni.
Toutes les lignes de journal sont balisées avec un nom d'hôte et une balise d'environnement et peuvent être examinées dans vRealize Log Insight. Dans un environnement à haute disponibilité (HA), les journaux sont balisés avec des noms d'hôte différents, en fonction du nœud sur lequel ils ont été créés. La balise d'environnement peut être configurée avec l'option --environment ENV comme décrit ci-dessous dans la section Configurer ou mettre à jour l'intégration de vRealize Log Insight. Dans un environnement HA, la balise d'environnement a la même valeur pour toutes les lignes de journal, quel que soit le nœud sur lequel elle a été créée.
Vous pouvez obtenir des informations sur l'utilisation de l'utilitaire de ligne de commande vracli en utilisant l'argument --help dans la ligne de commande vracli. Par exemple : vracli vrli --help. Pour une réponse conviviale, commencez la commande par vracli -j vrli.
Vérifier la configuration existante de vRealize Log Insight
Commandvracli vrli
Il n'y a aucun argument de ligne de commande.
OutputLa sortie de la configuration actuelle de l'intégration de vRealize Log Insight est au format JSON.
Exit codes- 0 - L'intégration à vRealize Log Insight est configurée.
- 1 - Une exception s'est produite dans le cadre de l'exécution de la commande. Pour plus de détails, consultez le message d'erreur.
- 61 (ENODATA) - L'intégration à vRealize Log Insight n'est pas configurée. Pour plus de détails, consultez le message d'erreur.
$ vracli vrli
No vRLI integration configured
$ vracli vrli
{
"agentId": "0",
"environment": "prod",
"host": "my-vrli.local",
"port": 9543,
"scheme": "https",
"sslVerify": false
}
Configurer ou mettre à jour l'intégration de vRealize Log Insight
Commandvracli vrli set [options] FQDN_OR_URL
- FQDN_OR_URL
Spécifie le nom de domaine complet ou l'URL du serveur vRealize Log Insight à utiliser pour la publication des journaux. Le port 9543 et https sont utilisés par défaut. Si l'un de ces paramètres doit être modifié, vous pouvez utiliser une URL à la place.
vracli vrli set <options> https://FQDN:9543
Note :Vous pouvez définir un autre schéma (https est utilisé par défaut) et un autre port (la valeur par défaut pour https est 9543, 9000 pour http) d'hôte à utiliser pour l'envoi des journaux, comme indiqué dans les exemples suivants :vracli vrli set https://HOSTNAME:9543 vracli vrli set --insecure HOSTNAME vracli vrli set http://HOSTNAME:9000
Le port 9543 pour https et le port 9000 pour http sont utilisés par la REST API d'ingestion de vRealize Log Insight tel que décrit dans les sections Administration de vRealize Log Insight et Ports et interfaces externes de la documentation de vRealize Log Insight.
- Options
- --agent-id SOME_ID
Définit l'ID de l'agent de journalisation pour ce dispositif. La valeur par défaut est
0. Utilisé pour identifier l'agent lors de la publication de journaux sur vRealize Log Insight à l'aide de vRealize Log Insight REST API. - --environment ENV
Définit un identifiant pour l'environnement actuel. Il sera disponible dans les journaux vRealize Log Insight en tant que balise pour chaque entrée de journal. La valeur par défaut est
prod. - --ca-file /path/to/server-ca.crt
Spécifie un fichier qui contient le certificat de l'autorité de certification (CA) qui a été utilisé pour signer le certificat du serveur vRealize Log Insight. Cela force l'agent de journalisation à approuver l'autorité de certification spécifiée et à l'activer pour vérifier le certificat du serveur vRealize Log Insight s'il a été signé par une autorité non approuvée. Le fichier peut contenir une chaîne de certificats complète pour vérifier le certificat. Dans le cas d'un certificat auto-signé, transmettez le certificat lui-même.
- --ca-cert CA_CERT
La définition est identique à celle de --ca-file ci-dessus, mais transmet plutôt le certificat (chaîne) en ligne en tant que chaîne.
- --insecure
Désactive la vérification SSL du certificat de serveur. Cela force l'agent de journalisation à accepter n'importe quel certificat SSL lors de la publication de journaux.
- --agent-id SOME_ID
- Options avancées
- --request-max-size BYTES
Plusieurs événements de journalisation sont ingérés avec un seul appel d'API. Cet argument contrôle la taille maximale de la charge utile, en octets, pour chaque demande. Les valeurs valides sont comprises entre 4 000 et 4 000 000. La valeur par défaut est 256 000. Pour obtenir des informations connexes sur les valeurs autorisées, consultez Ingestion d'événements vRealize Log Insight dans la documentation de vRealize Log Insight REST API. Si cette valeur est trop basse, les événements de journalisation dépassant la taille autorisée risquent d'être perdus.
- --request-timeout SECONDS
Un appel à l'API peut se bloquer pour plusieurs raisons, notamment des problèmes de mise en réseau distante, etc. Ce paramètre contrôle le nombre de secondes d'attente pour l’exécution de chaque opération, par exemple l'ouverture d'une connexion, l'écriture de données ou l'attente d'une réponse, avant qu’un appel soit reconnu comme ayant échoué. La valeur ne peut pas être inférieure à 1 seconde. La valeur par défaut est 30.
- --request-immediate-retries RETRIES
Les journaux sont mis en mémoire tampon dans des blocs agrégés avant d'être envoyés à vRealize Log Insight (voir --buffer-flush-thread-count ci-dessous). Si une demande d'API échoue, le journal est rétenté immédiatement. Le nombre de tentatives immédiates par défaut est 3. Si aucune des nouvelles tentatives n'aboutit, l'intégralité du bloc de journal est restaurée et est retentée ultérieurement.
- --request-http-compress
Pour réduire les volumes de trafic réseau, vous pouvez appliquer une compression gzip aux demandes envoyées au serveur vRealize Log Insight. Si ce paramètre n’est pas spécifié, aucune compression n’est utilisée.
- --buffer-flush-thread-count THREADS
Pour de meilleures performances et pour limiter le trafic de mise en réseau, les journaux sont mis en mémoire tampon localement par blocs avant d'être vidés et envoyés au serveur de journalisation. Chaque bloc contient des journaux provenant d'un seul service. Selon votre environnement, les blocs peuvent devenir volumineux et longs à vider. Cet argument contrôle le nombre de blocs pouvant être vidés simultanément. La valeur par défaut est 2.
- --request-max-size BYTES
Lors de la configuration de l'intégration sur https, si le serveur vRealize Log Insight est configuré pour utiliser un certificat non approuvé, tel qu'un certificat auto-signé ou un certificat signé par une autorité non approuvée, vous devez utiliser l'une des options --ca-file, --ca-cert ou --insecure. Dans le cas contraire, l'agent de journalisation ne parvient pas à valider l'identité du serveur et n'envoie pas de journaux. Lorsque vous utilisez --ca-file ou --ca-cert, le certificat du serveur vRealize Log Insight doit être valide pour le nom d'hôte du serveur. Dans tous les cas, vérifiez l'intégration en prévoyant quelques minutes pour le traitement, puis en vérifiant que vRealize Log Insight a bien reçu les journaux.
Aucune sortie n'est attendue.
Exit codes- 0 - La configuration a été mise à jour.
- 1 - Une exception s'est produite lors de l'exécution. Pour plus de détails, consultez le message d'erreur.
vracli vrli set {somehost} ou
vracli vrli set --ca-file path/to/server-ca.crt pour modifier l'ID d'agent ou les valeurs d'environnement par défaut. Pour plus d'informations, reportez-vous à l'aide en ligne de la commande en exécutant
vracli vrli --help.
$ vracli vrli set my-vrli.local $ vracli vrli set 10.20.30.40 $ vracli vrli set --ca-file /etc/ssl/certs/ca.crt 10.20.30.40 $ vracli vrli set --ca-cert "$(cat /etc/ssl/certs/ca.crt)" 10.20.30.40 $ vracli vrli set --insecure http://my-vrli.local:8080 $ vracli vrli set --agent-id my-vrli-agent my-vrli.local $ vracli vrli set --request-http-compress $ vracli vrli set --environment staging my-vrli.local $ vracli vrli set --environment staging --request-max-size 10000 --request-timeout 120 --request-immediate-retries 5 --buffer-flush-thread-count 4 my-vrli.local
Effacer l'intégration de vRealize Log Insight
Commandvracli vrli unset
Il n'y a aucun argument de ligne de commande.
OutputLa sortie de la confirmation est au format texte simple.
Exit codes- 0 - La configuration a été effacée ou aucune configuration n'existait.
- 1 - Une exception s'est produite lors de l'exécution. Pour plus de détails, consultez le message d'erreur.
$ vracli vrli unset Clearing vRLI integration configuration $ vracli vrli unset No vRLI integration configured