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 l'API de vRealize Log Insight. 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 l'API de vRealize Log Insight, consultez la documentation de vRealize Log Insight et également la page /api/v1/events/ingest/{agentId}.

Configurez l'agent de journalisation pour qu'il transfère automatiquement et continuellement les journaux vRealize Automation vers vRealize Log Insight à l'aide de l'utilitaire de ligne de commande vracli fourni.

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

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": 443,
    "scheme": "https",
    "sslVerify": false
}
Note :
Vous pouvez définir un autre schéma (la valeur par défaut est https) et port (la valeur par défaut est 443) d'hôte à utiliser pour l'envoi des journaux, comme indiqué dans les exemples suivants :
vracli vrli set some-host
vracli vrli set some-host:9543
vracli vrli set http://some-host:9543

Le port 9543 est utilisé par l'API d'ingestion de vRealize Log Insight comme décrit dans la rubrique Administration de vRealize Log Insight de la section Ports et interfaces externes dans la Documentation vRealize log Insight.

Configurer ou mettre à jour l'intégration de vRealize Log Insight

Command

vracli vrli set [options] FQDN_OR_URL

Arguments
Les arguments de ligne de commande suivants sont disponibles :
  • FQDN_OR_URL - Nom de domaine complet ou adresse IP du serveur vRealize Log Insight qui doit être utilisé pour publier les journaux à l'aide de la configuration de l'API de vRealize Log Insight. Le port 443 et un schéma HTTPS sont utilisés par défaut. Si l'un de ces paramètres doit être modifié, vous pouvez utiliser une URL à la place.
  • options
    • --agent-id SOME_ID - Définissez l'ID de l'agent de journalisation pour ce dispositif. La valeur par défaut est 0. Permet d'identifier l'agent de journalisation pour les journaux publiés vers vRealize Log Insight à l'aide de la configuration de l'API de vRealize Log Insight.
    • --environment ENV - Définissez un identifiant pour l'environnement actuel. Il sera disponible dans les journaux vRealize Log Insight en tant que balise pour chaque événement de ligne de journal. La valeur par défaut est prod.
    • --ca-file /path/to/server-ca.crt - Spécifiez un fichier contenant le certificat de l'autorité de certification (CA) qui a été utilisé pour signer le certificat de serveur vRealize Log Insight. Forcez l'agent de journalisation à approuver l'autorité de certification spécifiée et activez-la pour vérifier le certificat du serveur vRealize Log Insight. Le fichier peut contenir une chaîne de certificats complète, si nécessaire, pour vérifier le certificat. Dans le cas d'un certificat auto-signé, transmettez le certificat lui-même.
    • --ca-cert CA_CERT - Spécifiez un fichier de la même manière que pour --ca-file, mais transmettez le certificat (chaîne) en ligne en tant que chaîne.
    • --insecure - Désactivez la vérification SSL du certificat de serveur. Forcez l'agent de journalisation à accepter n'importe quel certificat SSL lors de la publication de 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 --environment staging my-vrli.local

Effacer l'intégration de vRealize Log Insight

Command

vracli vrli unset

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 possibles :
  • 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