Documentation Oracle Cloud Infrastructure

Collecte de mesures

A propos des mesures personnalisées

  • Permettre aux utilisateurs de configurer la façon dont les mesures de leurs étendues sont collectées en fonction de leurs besoins en matière de reporting.
  • Les utilisateurs peuvent configurer leurs propres définitions de mesures en fonction des propriétés des étendues, ce qui leur permet de configurer des méthodes personnalisées de surveillance de leurs applications.
  • Les mesures personnalisées utilisent des filtres d'étendue pour sélectionner les étendues pour lesquelles les mesures doivent être calculées. Les utilisateurs peuvent ainsi définir différents ensembles de mesures pour différents types d'étendue.
  • Pour le reporting détaillé, des dimensions peuvent être affectées aux métriques, ce qui permet de les regrouper et de les filtrer en fonction de ces dimensions. Par exemple, signaler les utilisateurs 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éez une mesure pour suivre le nombre d'erreurs survenues lors de l'étape de paiement.

Pour ce cas d'emploi, vous devez identifier les étendues qui ont échoué lors de l'étape de paiement. En supposant que l'URL de la page de paiement se termine par checkout.jsp, vous pouvez définir une valeur Span Filter qui vérifie si l'attribut HttpUrl se termine par checkout.jsp et vérifie également si l'attribut Error est défini sur True.

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

En tant que source de valeur, sélectionnez SpanErrorCount. La valeur 1 s'affiche en cas d'erreur dans la page et 0 dans le cas contraire. 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 ce faire, vous pouvez utiliser la source de valeur 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'

Ensuite, sélectionnez PageResponseTime pour la source de valeur. En outre, vous pouvez ajouter des dimensions à votre convenance. 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 comme suit :

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

    La page Détails du domaine apparaît.

  • Accédez à Ressources, en bas à gauche, puis cliquez sur Mesures personnalisées.

    Le panneau Mesures personnalisées apparaît.

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

    La fenêtre Créer une mesure personnalisée apparaît.

    • Entrez le nom de mesure de la nouvelle mesure personnalisée.
    • Dans la zone Filtre d'étendue, choisissez un filtre d'étendue prédéfini (global) ou saisissez-le dans une définition de filtre d'étendue locale.
    • 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 maximum de dimensions est de 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 étendues récemment incluses correspondent au filtre d'étendue configuré. L'outil de validation permet de vérifier les étendues incluses jusqu'à 24 heures dans le passé.
    • Cliquez sur Suivant pour passer aux options Choisir un stockage de mesure.
    • 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 de toutes les mesures personnalisées est oracle_apm_custom.

      Utiliser un espace de noms personnalisé : si vous préférez, vous pouvez fournir un espace de noms personnalisé à utiliser par la mesure personnalisée.

      Lorsque vous utilisez un espace de noms autre que celui par défaut, une stratégie 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 préféré.
      • Le message Stratégie requise pour le nouvel espace de noms apparaît, indiquant que la stratégie 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 stratégie ci-dessus permet au service OCI Application Performance Monitoring de publier dans l'espace de noms personnalisé.

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

          Utilisez cette option si vous ne disposez pas des droits d'accès nécessaires pour créer des stratégies dans OCI. Dans la plupart des cas, un administrateur doit créer la stratégie.

        • Valider la stratégie : la stratégie est validée à l'aide d'une mesure de test et en vérifiant les droits d'accès dans l'espace de noms personnalisé.
        • Appliquer la stratégie : la stratégie est créée automatiquement.

          Utilisez cette option si vous disposez des droits d'accès nécessaires pour créer des stratégies dans OCI. Par exemple, si vous disposez des autorisations d'administrateur.

        Pour plus d'informations sur la création de stratégies, reportez-vous à Création d'une stratégie dans la documentation 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 d'un espace de noms personnalisé, vérifiez si le service Application Performance Monitoring a accès en écriture à 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 voulez 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 stratégie ci-dessus est appliquée à l'espace de noms personnalisé.