Chapitre 9. Visualiser les logs des clusters à l'aide de Kibana
Le sous-système de journalisation comprend une console web pour visualiser les données de journalisation collectées. Actuellement, OpenShift Container Platform déploie la console Kibana pour la visualisation.
Le visualiseur de journal vous permet d'effectuer les opérations suivantes avec vos données :
- rechercher et parcourir les données à l'aide de l'onglet Discover.
- et cartographier les données à l'aide de l'onglet Visualize.
- créer et afficher des tableaux de bord personnalisés à l'aide de l'onglet Dashboard.
L'utilisation et la configuration de l'interface Kibana sortent du cadre de cette documentation. Pour plus d'informations sur l'utilisation de l'interface, consultez la documentation Kibana.
Les journaux d'audit ne sont pas stockés dans l'instance interne d'OpenShift Container Platform Elasticsearch par défaut. Pour afficher les journaux d'audit dans Kibana, vous devez utiliser l'API Log Forwarding pour configurer un pipeline qui utilise la sortie default pour les journaux d'audit.
9.1. Définir les modèles d'index Kibana
Un modèle d'index définit les index Elasticsearch que vous souhaitez visualiser. Pour explorer et visualiser des données dans Kibana, vous devez créer un modèle d'index.
Conditions préalables
Un utilisateur doit avoir le rôle
cluster-admin, le rôlecluster-readerou les deux rôles pour voir les index infra et audit dans Kibana. L'utilisateur par défautkubeadmindispose des autorisations nécessaires pour afficher ces index.Si vous pouvez voir les pods et les journaux dans les projets
default,kube-etopenshift-, vous devriez pouvoir accéder à ces index. Vous pouvez utiliser la commande suivante pour vérifier si l'utilisateur actuel dispose des autorisations appropriées :$ oc auth can-i get pods/log -n <projet>
Exemple de sortie
yes
NoteLes journaux d'audit ne sont pas stockés dans l'instance interne d'OpenShift Container Platform Elasticsearch par défaut. Pour afficher les journaux d'audit dans Kibana, vous devez utiliser l'API Log Forwarding pour configurer un pipeline qui utilise la sortie
defaultpour les journaux d'audit.- Les documents Elasticsearch doivent être indexés avant de pouvoir créer des modèles d'index. Cette opération est effectuée automatiquement, mais elle peut prendre quelques minutes dans un cluster nouveau ou mis à jour.
Procédure
Pour définir des modèles d'index et créer des visualisations dans Kibana :
-
Dans la console OpenShift Container Platform, cliquez sur le lanceur d'applications
et sélectionnez Logging.
Créez vos modèles d'index Kibana en cliquant sur Management
Index Patterns Create index pattern: -
Chaque utilisateur doit créer manuellement des modèles d'index lors de sa première connexion à Kibana pour voir les journaux de ses projets. Les utilisateurs doivent créer un modèle d'index nommé
appet utiliser le champ@timestamptime pour afficher les journaux de leurs conteneurs. -
Chaque utilisateur administrateur doit créer des modèles d'index lors de sa première connexion à Kibana pour les index
app,infra, etauditen utilisant le champ@timestamptime.
-
Chaque utilisateur doit créer manuellement des modèles d'index lors de sa première connexion à Kibana pour voir les journaux de ses projets. Les utilisateurs doivent créer un modèle d'index nommé
- Créer des visualisations Kibana à partir des nouveaux modèles d'index.
