Documentation sur Oracle Cloud Infrastructure

Mesures personnalisées

À propos des mesures personnalisées

  • Permettre aux utilisateurs de configurer la façon dont les mesures de leurs intervalles sont collectées en fonction de leurs besoins en matière de production de rapports.
  • Les utilisateurs peuvent configurer leurs propres définitions de mesures en fonction des propriétés des intervalles, ce qui leur permet de configurer des méthodes personnalisées de surveillance de leurs applications.
  • Les mesures personnalisées utilisent des filtres d'intervalle pour sélectionner les intervalles pour lesquels les mesures doivent être calculées. Les utilisateurs peuvent ainsi définir différents jeux de mesures pour différents types d'intervalles.
  • Pour des rapports détaillés, il est possible d'affecter des dimensions aux mesures, ce qui permet le regroupement et le filtrage en fonction de ces dimensions. Par exemple, les utilisateurs de rapports par type de navigateur ou les articles vendus par pays.
  • Les mesures personnalisées sont configurées au niveau du domaine APM.

Exemples de cas d'utilisation de mesures personnalisées

Exemple 1 : Créer une mesure pour suivre le nombre d'erreurs survenues lors de l'étape de validation de commande.

Pour ce cas d'utilisation, vous devez identifier les intervalles qui ont échoué lors de l'étape de validation de commande. En supposant que l'URL de la page de validation de commande se termine par checkout.jsp, vous pouvez définir une Span Filter qui vérifie si l'attribut HttpUrl se termine par checkout.jsp et vérifie également si l'attribut Error est réglé à Vrai.

HttpUrl like '%checkout.jsp' AND Error = 'true'

En tant que source de valeur, sélectionnez SpanErrorCount. La valeur 1 sera affectée si une erreur s'est produite dans la page et 0 sinon. En outre, il peut être intéressant de savoir si les erreurs se produisent uniquement avec des navigateurs spécifiques afin que vous puissiez ajouter la dimension BrowserName.

Exemple 2 : Créer une mesure pour suivre le temps de réponse de la page d'accueil

Dans ce scénario, nous voulons suivre le temps de réponse de notre page d'accueil. Pour cela, vous pouvez utiliser la source de valeurs PageResponseTime. Vous pouvez configurer un élément Span Filter pour qu'il corresponde à votre page d'accueil nommée home.php.

HttpUrl like '%home.php' AND ApmrumType = 'PAGE'

Sélectionnez maintenant PageResponseTime pour la source de valeurs. De plus, vous pouvez ajouter des cotes selon vos besoins. Par exemple, GeoCountry pour obtenir une répartition des temps de réponse par pays.

Gérer les mesures personnalisées

Pour créer une mesure personnalisée pour un domaine APM souhaité, procédez de la façon suivante :

  • Allez à la page Domaines APM et cliquez sur le domaine APM souhaité.

    La page Détails du domaine s'affiche.

  • Allez à Ressources, en bas à gauche, puis cliquez sur Mesures personnalisées

    Le volet Mesures personnalisées s'affiche.

  • Dans le volet Mesures personnalisées, cliquez sur Créer une mesure personnalisée.

    La fenêtre Créer une mesure personnalisée s'affiche.

    • Entrez le nom de la mesure de la nouvelle mesure personnalisée.
    • Dans la zone Filtre d'intervalle, sélectionnez un filtre d'intervalle prédéfini (global) ou entrez-le dans une définition de filtre d'intervalle local.
    • Dans la liste déroulante Source de valeur de mesure, sélectionnez une mesure.
    • Facultatif : Dans la liste déroulante Dimension(s), sélectionnez une ou plusieurs dimensions. Le nombre maximal de dimensions est 10.
    • Facultatif : Dans la liste déroulante Unité de mesure, sélectionnez une unité de mesure.
    • Facultatif : Cliquez sur Valider la mesure personnalisée pour vérifier si des intervalles récemment ingérés correspondent au filtre d'intervalle configuré. L'outil de validation permet de vérifier les intervalles ingérés jusqu'à 24 heures dans le passé.
    • Cliquez sur Suivant pour passer aux options Sélectionner le stockage des mesures.
    • Dans la liste déroulante Compartiment, sélectionnez un compartiment.
    • Dans le champ Espace de noms, entrez un espace de noms.

      L'espace de noms par défaut pour toutes les mesures personnalisées est oracle_apm_custom.

      Utiliser un espace de noms personnalisé : Si vous le souhaitez, vous pouvez fournir un espace de noms personnalisé à utiliser par la mesure personnalisée.

      Lors de l'utilisation d'un espace de noms autre que par défaut, une politique est requise pour être créée pour le nouvel espace de noms.

      • Dans le champ Espace de noms, modifiez la valeur par défaut et entrez l'espace de noms privilégié.
      • Le message Politique requise pour le nouvel espace de noms s'affiche et indique que la politique suivante est requise : 
        Allow service applicationperformancemonitoring to manage metrics in compartment <compartment_name> where target.metrics.namespace=<custom_namespace_name>
        Par exemple :
        Allow service applicationperformancemonitoring to manage metrics in compartment ABC where target.metrics.namespace=namespace2

        La politique ci-dessus permet au service OCI Application Performance Monitoring de publier dans l'espace de noms personnalisé.

        Les options suivantes sont disponibles :
        • Copier la politique : La politique est copiée dans le presse-papiers et doit être créée manuellement à l'aide de la console OCI.

          Utilisez cette option si vous n'êtes pas autorisé à créer des politiques dans OCI. Dans la plupart des cas, un utilisateur administrateur doit créer la politique.

        • Valider la politique : La politique est validée à l'aide d'une mesure de test et en vérifiant les autorisations dans l'espace de noms personnalisé.
        • Appliquer la politique : La politique est créée automatiquement.

          Utilisez cette option si vous êtes autorisé à créer des politiques dans OCI. Par exemple, si vous disposez des autorisations d'administrateur.

        Pour plus d'informations sur la création de politiques, voir Création d'une politique dans la documentation sur Identity Management.

    • Facultatif : Dans la liste déroulante Groupe de ressources, sélectionnez un groupe de ressources.
    • Cliquez sur Créer.

      Si le processus de création échoue lors de l'utilisation de l'espace de noms personnalisé, vérifiez si le service Application Performance Monitoring a accès à l'écriture dans l'espace de noms personnalisé.

Utilisez le menu d'actions pour modifier ou supprimer une mesure personnalisée.

Si vous disposez d'une mesure personnalisée existante et que vous souhaitez la mettre à jour pour commencer à utiliser un espace de noms personnalisé (au lieu d'utiliser l'espace de noms par défaut oracle_apm_custom), assurez-vous que la politique ci-dessus est appliquée à l'espace de noms personnalisé.