Configurer la collection de commandes OS

Prérequis pour la configuration de la collecte de la sortie de commande du système d'exploitation

Effectuez les tâches prérequises suivantes avant de configurer la collecte de journaux :

• Créez un script personnalisé composé d'une commande du système d'exploitation, dont la sortie peut être collectée dans Oracle Log Analytics en tant que journaux. La sortie STDOUT du script est envoyée en tant que charge utile par l'agent vers le cloud. La charge utile STDOUT peut être une entrée de journal unique ou plusieurs entrées de journal. Assurez-vous que l'analyseur utilisé dans la source Oracle Log Analytics peut l'analyser. En outre, le script doit être en mesure de gérer les conditions d'erreur et de vérifier les prérequis.

  Stockez le script personnalisé sous le dossier agent_inst/state/laStorage/os_cmd/scripts dans le dossier d'installation de l'agent. Par conséquent, le chemin absolu de stockage du script est :

  • Pour Oracle Management Agent : /opt/oracle/mgmt_agent/agent_inst/state/laStorage/os_cmd/scripts
  • Pour le module d'extension Agent-Agent de gestion Oracle Cloud : /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/state/laStorage/os_cmd/scripts

• Des autorisations de fichier spéciales peuvent être fournies pour exécuter des commandes particulières dans le script. Configurez manuellement ces autorisations sur l'hôte de l'agent. Le script et toutes les autres commandes/scripts qu'il exécute doivent disposer du droit d'accès execute pour l'utilisateur de l'agent OMA.

Flux global de collecte des journaux de commandes du système d'exploitation

Les tâches de haut niveau suivantes permettent de collecter la sortie d'un script de commande du système d'exploitation :

• Installez l'agent OMA sur l'hôte sur lequel vous voulez exécuter les scripts de commande du système d'exploitation et générez la sortie à collecter dans Oracle Log Analytics. Reportez-vous à Configuration de la collecte de journaux continue à l'aide de l'agent de gestion.

• Créez une entité pour identifier l'hôte de l'agent dans Oracle Log Analytics. L'entité doit se trouver sur le même hôte que l'agent OMA où le script sera exécuté. L'exécution de la commande du système d'exploitation distant n'est pas prise en charge. En général, l'entité est créée automatiquement lorsque vous installez l'agent OMA. Reportez-vous à Création d'une entité pour représenter votre ressource émettrice de journal.

• Créez un analyseur qui peut analyser la sortie du script. Cet analyseur doit être utilisé dans la source qui sera identifiée à l'étape suivante. Reportez-vous à Création d'un analyseur.
• Identifiez une source existante ou créez une source de journal de type Commande OS. Reportez-vous à Création d'une source de commande OS.
• Vérifiez si vous souhaitez configurer la propriété de collection d'agents customized_schedule pour définir l'intervalle de collecte de la collection de commandes du système d'exploitation. La valeur par défaut est 30 seconds. Vous pouvez mettre à jour la programmation au niveau de l'agent, de la source, de l'entité ou de l'association à l'aide des propriétés de collection d'agents. Reportez-vous à Propriétés d'agent que vous pouvez modifier et à Modification des propriétés d'agent.

• Associez les entités à la source que vous avez créée précédemment. Reportez-vous à Configuration d'une nouvelle association source-entité.

  Une fois l'association terminée, l'agent commence à exécuter la commande du système d'exploitation de façon périodique, le STDOUT de la commande est collecté en tant que données de journal et ces données de journal commencent à circuler dans Oracle Log Analytics.

• Affichez les données de journal dans l'explorateur de journaux en sélectionnant la source de commande du système d'exploitation que vous avez créée précédemment. Reportez-vous à Filtrage des journaux par attribut de source.

Si les données de journal n'apparaissent pas dans l'explorateur de journaux une fois la configuration terminée, vous pouvez rechercher les avertissements de collecte d'agent en cas de problème. Les avertissements suivants sont spécifiquement liés à la collecte de sortie des commandes du système d'exploitation :

• Echec d'exécution de l'application externe : une erreur s'est produite lors de l'exécution du script ou la commande du système d'exploitation n'est pas prise en charge.

• Application externe introuvable : script introuvable, aucun droit d'accès en lecture/exécution sur le script.

Reportez-vous à Affichage des avertissements de collecte d'agent.

Facteurs importants à prendre en compte lors de la configuration de la collecte de commandes de système d'exploitation

• Utilisez le chemin complet des commandes dans les scripts ; par exemple, utilisez /bin/sudo au lieu de sudo.

• Les scripts sont exécutés avec le même utilisateur que l'agent OMA. Ceci est important lors de la lecture ou de l'écriture de fichiers dans un script.

• La sortie générée par le script sur Sortie standard (STDOUT) et Erreur standard (STDERR) est collectée en tant que texte pour extraire les entrées de journal.

• Les mots ou préfixes suivants ne sont pas pris en charge dans la commande de système d'exploitation ni dans le nom du script : sh, bash, csh, zsh, ksh, dash, cmd

• Les caractères suivants ne sont pas pris en charge dans la commande du système d'exploitation ni dans le nom du script : |, &, ;, >, <

• Les séquences de parcours de répertoire parent suivantes ne sont pas prises en charge dans la commande du système d'exploitation ni dans le nom du script : /../ ou \..\. En outre, la commande du système d'exploitation ne peut pas se terminer par /.. ou \...

• La variable d'environnement suivante est transmise aux scripts de l'agent. Vous pouvez utiliser la variable dans les scripts.

  • LA_SOURCE_COMMAND_ID : ID de modèle généré en interne de la commande dans la source de journal. Il peut être utilisé pour différencier les instances de script si le même script est fourni dans plusieurs commandes.