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, consultez 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

Note : Vous ne pouvez configurer qu’une seule intégration de journalisation à distance. vRealize Log Insight a priorité si un serveur vRealize Log Insight et un serveur Syslog sont disponibles.

Vérifier la configuration existante de vRealize Log Insight

Command

vracli vrli

Arguments

Il n'y a aucun argument de ligne de commande.

Output

La sortie de la configuration actuelle de l'intégration de vRealize Log Insight est au format JSON.

Exit codes
Les codes de sortie suivants sont possibles :
  • 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.
Example - check integration configuration
$ 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

Command

vracli vrli set [options] IP_OR_URL

Note : Après l'exécution de la commande, l'agent de journalisation peut prendre jusqu'à 2 minutes pour appliquer la configuration spécifiée.
Arguments
  • IP_OR_URL

    Spécifie l'adresse IP 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.

    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://IP:9543
    vracli vrli set --insecure IP
    vracli vrli set http://http://IP: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 dans 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 pour 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.

  • 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 4000 et 4000000. La valeur par défaut est 256000. 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 d'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, au terme duquel l'appel est 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éessayé 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.

Note :

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.

Output

Aucune sortie n'est attendue.

Exit codes
Les codes de sortie suivants sont possibles :
  • 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.
Examples - Configure or update integration configuration
$ 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

Command

vracli vrli unset

Note : Après l'exécution de la commande, l'agent de journalisation peut prendre jusqu'à 2 minutes pour appliquer la configuration spécifiée.
Arguments

Il n'y a aucun argument de ligne de commande.

Output

La sortie de la confirmation est au format texte simple.

Exit codes
Les codes de sortie suivants sont disponibles :
  • 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.
Examples - Clear integration
$ vracli vrli unset
Clearing vRLI integration configuration
 
$ vracli vrli unset
No vRLI integration configured