Création de tableaux de bord
Vous pouvez créer des tableaux de bord personnalisés sur la page Tableaux de bord en ajoutant les widgets définis par Oracle ou les widgets personnalisés que vous avez créés. Vous pouvez également créer un doublon de l'un des tableaux de bord disponibles et le personnaliser en fonction de vos besoins.
Rubriques :
Pour gérer un tableau de bord et ses composants, reportez-vous à la documentation relative au tableau de bord de gestion :
-
Gérer les tableaux de bord : accédez aux tableaux de bord, créez un tableau de bord personnalisé, personnalisez un tableau de bord défini par Oracle, exportez et importez des tableaux de bord, et configurez un tableau de bord inter-région.
-
Gérer les widgets : créez un widget d'explorateur de données de mesure, créez un widget basé sur une requête et ajoutez un groupe de widgets.
Rubriques supplémentaires pour Logging Analytics :
-
Lorsque vous importez un tableau de bord, des recherches enregistrées peuvent lui être associées. Ces recherches enregistrées sont également importées. Le fichier de configuration peut contenir des informations sur plusieurs tableaux de bord lorsque vous les avez exportés à l'aide de l'interface de ligne de commande ou de l'API REST. Le fichier de configuration contient également des informations sur le compartiment de chaque tableau de bord et ses recherches enregistrées.
-
Lorsque vous importez un tableau de bord d'une location à une autre, vérifiez que le contenu des sections scopeFilters est valide dans le locataire de destination. Les sections scopeFilters font référence au compartiment, à la région, aux entités et aux ensembles de journaux du groupe de journaux dans le locataire source. Ces valeurs de ressource seront différentes dans le locataire de destination. Supprimez ou modifiez les valeurs, si nécessaire.
Etapes de création du tableau de bord :
Pour connaître l'étape détaillée de création d'un tableau de bord, reportez-vous à la rubrique Création d'un tableau de bord personnalisé.
Dans les widgets Oracle Logging Analytics, les entrées Compartiment de groupe de journaux, Région et Entité définissent la portée de toutes les requêtes, mais ne modifient pas la requête. Toutes les autres entrées que vous ajoutez au widget à l'aide du bouton Ajouter une entrée modifient la requête en ajoutant le prédicat <fieldname> = <values...>
. Pour cela, toute entrée que vous ajoutez doit avoir un nom de paramètre correspondant à un nom de champ de journal dans Oracle Logging Analytics.
Une fois que vous avez créé un tableau de bord, cliquez sur son nom sur la page Tableaux de bord pour l'afficher. Vous pouvez utiliser les options suivantes de la page Tableau de bord pour effectuer d'autres tâches :
- Cliquez sur l'icône Ouvrir
d'un widget pour ouvrir ce widget dans l'explorateur de journaux et apporter des modifications. Si vous voulez apporter des modifications à un widget créé par un autre utilisateur, vous pouvez cliquer sur l'option Enregistrer sous dans l'explorateur de journaux pour créer une copie du widget et apporter les modifications correspondant à vos besoins. La copie du widget n'est pas ajoutée automatiquement au tableau de bord ; vous devez modifier le tableau de bord et l'ajouter.
-
Cliquez sur Modifier pour modifier le tableau de bord. Vous pouvez ajouter ou enlever des widgets personnalisés ou de mesure, et modifier le titre, la description, le compartiment de tableau de bord ou les filtres associés aux widgets.
- Pour masquer les filtres utilisés dans le tableau de bord, cliquez sur l'icône Filtre de portée
. Pour plus d'informations sur les filtres de portée et leur contexte global dans Logging Analytics, reportez-vous à Utilisation des filtres de portée.
-
Cliquez sur l'icône Visualiser la requête
dans l'angle inférieur droit du widget pour visualiser la requête utilisée pour filtrer les journaux et générer l'analyse.
Pour plus d'informations sur les stratégies du tableau de bord de gestion qui affectent les droits d'accès requis afin d'utiliser les tableaux de bord, reportez-vous à Détails relatifs au tableau de bord de gestion.
Pour obtenir la documentation de l'API de tableau de bord de gestion, reportez-vous à API de tableau de bord de gestion.
Utilisation des tableaux de bord définis par Oracle
Oracle Logging Analytics fournit des tableaux de bord prédéfinis avec des widgets intégrés.
Les tableaux de bord définis par Oracle offrent un aperçu de l'analyse de certains des journaux importants. Oracle-defined dashboards available for Oracle Logging Analytics are Enterprise Network (VCNs) Overview, OCI API Gateway Overview, OCI Audit Analysis, VCN Flow Logs, Oracle Integration: Key metrics, Oracle Integration: Time Taken Analysis, Oracle Integration: Health Overview, Oracle Database Alert, Oracle Integration Insight, and Oracle Database Audit Analysis. Pour plus d'informations sur chaque tableau de bord, reportez-vous à Tableaux de bord définis par Oracle pour Logging Analytics.

Pour accéder aux tableaux de bord définis par Oracle, reportez-vous à Accès aux tableaux de bord. Toutes les visualisations Oracle Logging Analytics sont affichées dans les tableaux de bord sous leur forme native.
Sur la page Tableaux de bord, triez la liste des tableaux de bord sur la colonne Créé par et identifiez ceux qui ont été créés par Oracle
. Cliquez sur le nom du tableau de bord à ouvrir.
Le tableau de bord apparaît. Vous pouvez afficher les widgets définis par Oracle qui décrivent les paramètres clés des journaux pour lesquels le tableau de bord est créé. Vous pouvez modifier la période dans le sélecteur d'heure dans l'angle supérieur droit pour afficher les données d'une autre période. Utilisez le filtre de portée pour définir la portée du journal en indiquant dans le champ Log Group Compartment
, Region
où les données de journal sont disponibles ou la portée des entités à l'aide des champs Entity Compartment
et Entity
.
Pour afficher un widget dans l'explorateur de journaux, cliquez sur le bouton Afficher dans l'explorateur de journaux dans l'angle supérieur droit du widget.
Vous pouvez créer un doublon du tableau de bord défini par Oracle et y ajouter d'autres widgets ou le modifier pour créer votre tableau de bord personnalisé.
Pour personnaliser un tableau de bord défini par Oracle, reportez-vous à la rubrique Personnalisation d'un tableau de bord défini par Oracle.
Créer des filtres pour des cas d'emploi spécifiques
Différentes options sont disponibles pour configurer les filtres. Voici quelques-uns des cas d'utilisation où vous devrez peut-être créer des filtres et leur demander d'effectuer des tâches de manière spécifique.
Créer un filtre ayant un impact sur plusieurs widgets
Vous pouvez avoir un tableau de bord qui comporte plusieurs widgets et qui nécessite la même entrée d'un filtre, par exemple, Champ de journal. Ensuite, la valeur que vous sélectionnez dans le filtre Champ de journal sera appliquée à tous les widgets liés.
Cela serait utile lorsque vous souhaitez analyser la sortie des widgets en fonction d'une entrée de filtre.
Prenons le scénario où nous avons deux widgets db_demo
et sqldb_demo
qui nécessitent la valeur de source de journal d'entrée Linux Syslog Logs
à partir du filtre Log Field
. Ensuite, pour créer un filtre qui peut être utilisé par les deux widgets,
-
Accédez à la page de liste Tableaux de bord, puis cliquez sur celle qui doit être modifiée. La page des détails du tableau de bord s'ouvre. Cliquez sur Actions, puis sur Modifier.
-
Glissez-déplacez les widgets à partir du panneau Widgets et de l'onglet Ajouter des widgets.
-
Cliquez sur le panneau Filtres, puis sur Ajouter des filtres. Créez un filtre de champ de journal avec le nom de champ
Log Source
. Reportez-vous à Exemple de filtre : champ de journal.Accédez à l'onglet Modifier les filtres et modifiez le libellé du filtre de champ de journal, si nécessaire.
-
Accédez au panneau Widgets, puis cliquez sur Modifier les widgets. Ici, vous verrez les deux widgets que vous avez ajoutés précédemment, par exemple,
db_demo
etsqldb_demo
.Développez chaque widget pour le modifier. Cliquez sur Ajouter une entrée. La boîte de dialogue Configurer l'entrée s'ouvre.
Sélectionnez l'option Lier l'entrée à un filtre existant. Sous le menu Sélectionner un filtre existant, sélectionnez le filtre de champ de journal que vous avez ajouté précédemment au tableau de bord.
Cliquez sur Enregistrer les modifications.
Maintenant, vous avez lié les deux widgets au même filtre pour les entrées.
-
Enregistrez les modifications apportées au tableau de bord.
Désormais, le nouveau filtre que vous avez ajouté au tableau de bord, puis aux deux widgets, apparaît dans le filtre de portée lors de la visualisation du tableau de bord. Toute valeur d'entrée fournie dans le filtre, par exemple Linux Syslog Logs
, est immédiatement appliquée aux widgets et les journaux sont filtrés pour cette valeur.
Fournir une valeur d'entrée fixe à votre widget
Vous pouvez configurer l'entrée dans votre widget de sorte que la valeur de l'entrée soit statique et ne dépende pas d'autres filtres. Dans ce cas, la valeur d'entrée est codée en dur dans le widget.
Ceci est généralement requis lorsque l'entrée est une configuration unique uniquement pour un widget spécifique dans le tableau de bord et n'a pas besoin d'être partagée entre plusieurs widgets.
Considérons le scénario dans lequel le widget fixed_input_demo
affiche les journaux de plusieurs sources de journal. La requête utilisée pour le widget est la suivante :
* | stats count as logrecords by 'Log Source' | sort -logrecords
Si le widget doit afficher les journaux uniquement à partir de la source Linux Secure Logs
, le paramètre Log Source
et sa valeur Linux Secure Logs
peuvent être indiqués dans le widget de sorte que seuls les journaux de la source sélectionnée soient affichés.
-
Accédez à la page de liste Tableaux de bord, puis cliquez sur celle qui doit être modifiée. La page des détails du tableau de bord s'ouvre. Cliquez sur Actions, puis sur Modifier.
-
Glissez-déplacez le widget à partir du panneau Widgets et de l'onglet Ajouter des widgets.
-
Accédez au panneau Widgets, puis cliquez sur Modifier les widgets. Ici, vous verrez le widget que vous avez ajouté précédemment, par exemple,
fixed_input_demo
.Développez le widget pour le modifier. Cliquez sur Ajouter une entrée. La boîte de dialogue Configurer l'entrée s'ouvre.
Sélectionnez l'option Indiquer l'entrée. Indiquez le nom du paramètre et sa valeur, par exemple,
Log Source
et sa valeurLinux Secure Logs
.Cliquez sur Enregistrer les modifications.
-
Enregistrez les modifications apportées au tableau de bord.
Le widget affiche désormais les journaux uniquement à partir de la source indiquée. La requête efficace pour le widget est donc :
'Log Source' = 'Linux Secure Logs' | stats count as logrecords by 'Log Source' | sort -logrecords
Créer deux filtres où un filtre dépend de l'autre pour la saisie
Pour avoir un contrôle précis sur la sélection des entrées, vous pouvez imbriquer les filtres de sorte qu'un filtre reçoive les entrées de l'autre, qui peuvent ensuite être appliquées aux journaux.
Vous aurez généralement besoin de ce niveau de contrôle lorsque plusieurs valeurs de champs sont présentes dans votre grand ensemble de journaux et que les valeurs individuelles des champs peuvent être utilisées pour une analyse distincte. En outre, dans les cas où vous disposez d'un réseau composite ou d'une infrastructure volumineux à partir duquel vous collectez des journaux et que vous souhaitez configurer des contrôles pour effectuer une analyse descendante vers des journaux spécifiques.
Considérons le scénario dans lequel les journaux sont collectés à partir de plusieurs sources et types d'entité. Nous voulons maintenant filtrer les journaux par type d'entité en premier, et les sources en second. Pour ce faire, nous devons créer un filtre de champ de journal pour le champ Entity Type
, créer un filtre de champ de journal pour le champ Log Source
et lier son entrée au premier filtre. Ensuite, les journaux sont d'abord filtrés par type d'entité en fonction de la valeur que vous sélectionnez pour le type d'entité dans le filtre de portée. Ensuite, les journaux filtrés sont disponibles pour sélectionner les journaux par source.
Les étapes suivantes illustrent le processus de configuration des filtres pour le scénario ci-dessus :
-
Accédez à la page de liste Tableaux de bord, puis cliquez sur celle qui doit être modifiée. La page des détails du tableau de bord s'ouvre. Cliquez sur Actions, puis sur Modifier.
-
Créez un filtre de champ de journal avec le nom de champ
Entity Type
. Reportez-vous à Exemple de filtre : champ de journal.Accédez à l'onglet Modifier les filtres et remplacez le libellé du filtre de champ de journal par
Entity Type
, si nécessaire. -
Créez un filtre de champ de journal avec le nom de champ
Log Source
. Reportez-vous à Exemple de filtre : champ de journal.Accédez à l'onglet Modifier les filtres et remplacez le libellé du filtre de champ de journal par
Log Source
, si nécessaire. -
Accédez au panneau Filtres, puis cliquez sur Modifier les filtres. Ici, vous verrez les deux filtres que vous avez ajoutés précédemment.
Développez le filtre de champ de journal pour
Log Source
. Cliquez sur Ajouter une entrée. La boîte de dialogue Configurer l'entrée s'ouvre.Sélectionnez l'option Lier l'entrée à un filtre existant. Sélectionnez le filtre de type d'entité que vous avez ajouté précédemment.
Cliquez sur Enregistrer les modifications.
Vous avez maintenant lié les deux filtres avec succès. Le second filtre pour la source de journal dépend désormais du premier filtre pour le type d'entité pour les valeurs. Ainsi, en fonction de la valeur du type d'entité, seules les sources de journal apparaissent dans le second filtre pour la sélection applicable au type d'entité sélectionné.
Ajoutez le deuxième filtre comme entrée à votre widget pour voir le résultat de l'entrée de filtre en cascade.
-
Enregistrez les modifications apportées au tableau de bord.
Lorsque vous affichez le tableau de bord, dans le filtre de portée, vous pouvez d'abord effectuer une sélection parmi les types d'entité, par exemple, Host (Linux)
. Ensuite, dans l'ensemble filtré de journaux, vous pouvez sélectionner les valeurs des sources de journal, par exemple, Linux Audit Logs
, pour afficher l'ensemble final de journaux.
Notez que les options que vous pouvez sélectionner dans le second filtre dépendent de la sélection des valeurs dans le premier filtre.
Utiliser des filtres définis par Oracle
Oracle Logging Analytics fournit des filtres prêts que vous pouvez utiliser pour améliorer vos tableaux de bord et affiner le contrôle des données de journal sélectionnées pour analyse.
Vous pouvez filtrer les données de journal à l'aide des filtres définis par Oracle suivants :
-
Région
-
Compartiment du groupe de journaux
-
Entité
-
Compartiment
-
Filtre d'hôte
-
Filtre de base de données
-
Ensemble de journaux
-
Champ de journal
Pour obtenir un exemple de création d'un filtre pour un champ Logging Analytics, reportez-vous à Exemple de filtre : champ de journal.
Une fois que vous avez ajouté un filtre au tableau de bord, il peut être partagé par plusieurs widgets. Reportez-vous à Création d'un filtre ayant un impact sur plusieurs widgets.
Vous pouvez utiliser plusieurs filtres en combinaison de sorte que la sortie d'un filtre contrôle l'entrée d'un autre. Reportez-vous à Création de deux filtres en fonction de l'autre pour l'entrée.
Exemple de filtre : champ de journal
Champ de journal est l'un des filtres les plus puissants d'Oracle Logging Analytics qui vous permet d'indiquer n'importe quelle entrée de la plage de champs disponibles dans vos journaux.
Lorsque vous créez un filtre de champ de journal pour un champ, par exemple Entity Type
, vous facilitez une nouvelle entrée de type d'entité. Cette entrée peut avoir plusieurs valeurs, par exemple, Oracle Database Instance
, WebLogic Server
, Host (Linux)
, OCI API Gateway
, etc.
Dans cet exemple, nous créons un filtre pour les journaux provenant du type d'entité Host(Linux)
:
-
Accédez à la page de liste Tableaux de bord, puis cliquez sur celle qui doit être modifiée. La page des détails du tableau de bord s'ouvre. Cliquez sur Actions, puis sur Modifier.
-
Cliquez sur le panneau Filtres, puis sur Ajouter des filtres. Dans la liste des filtres définis par Oracle, cliquez sur
Log Field
. Le filtre de champ de journal est ensuite ajouté à la section des filtres du tableau de bord.La boîte de dialogue Configurer l'entrée de compartiment de groupe de journaux s'ouvre.
-
Sélectionnez le compartiment du groupe de journaux parmi les filtres disponibles dans votre tableau de bord ou ajoutez-lui un nouveau filtre. Cliquez sur Enregistrer les modifications.
La boîte de dialogue Configurer l'entrée Nom du champ de journal s'ouvre.
-
Vous pouvez sélectionner l'une des trois options pour indiquer le nom du champ de journal. Pour plus d'informations sur chaque option, reportez-vous à l'étape 5 dans Création d'un tableau de bord personnalisé.
Dans cet exemple, pour définir un filtre de type d'entité, sélectionnez l'option Indiquer l'entrée Nom du champ de journal, puis sélectionnez le nom du champ dans le menu déroulant. Sélectionnez
Entity Type
.Cliquez sur Enregistrer les modifications.
-
Accédez à l'onglet Modifier les filtres et modifiez le libellé du filtre de champ de journal, si nécessaire.
-
Glissez-déplacez le widget à partir du panneau Widgets et de l'onglet Ajouter des widgets.
Accédez au panneau Widgets, puis cliquez sur Modifier les widgets. Ici, vous verrez le widget que vous avez ajouté précédemment.
Développez le widget pour le modifier. Cliquez sur Ajouter une entrée. La boîte de dialogue Configurer l'entrée s'ouvre.
Sélectionnez l'option Lier l'entrée à un filtre existant. Sous le menu Sélectionner un filtre existant, sélectionnez le filtre de champ de journal que vous avez ajouté précédemment au tableau de bord. Lorsque vous sélectionnez cette option, vous pourrez spécifier la valeur du champ lorsque vous visiterez le tableau de bord.
Toutefois, si vous voulez corriger la valeur du champ, sélectionnez l'option Indiquer l'entrée et, sous Nom du paramètre, indiquez le nom exact du champ de journal que vous avez sélectionné précédemment, par exemple,
Entity Type
. Sous Entrer une valeur, indiquez la valeur du champ avec lequel filtrer les journaux, par exemple,Host(Linux)
.Cliquez sur Enregistrer les modifications.
Vous avez maintenant lié le widget au filtre de champ de journal pour l'entrée.
-
Enregistrez les modifications apportées à votre tableau de bord.
Consultez le tableau de bord pour voir le filtre de champ de journal dans la section Filtres de portée. Si vous n'avez pas corrigé la valeur de champ pour le widget, vous pouvez sélectionner l'une des options de la valeur de champ dans le filtre de portée et filtrer dynamiquement les journaux utilisés dans le widget pour l'analyse.