DocumentationExperience PlatformGuide des Insights d’observabilité

Point d’entrée des mesures

Last update: Fri Apr 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur

Les mesures d’observabilité fournissent des informations sur les statistiques d’utilisation, les tendances historiques et les indicateurs de performances des différentes fonctionnalités de Adobe Experience Platform. Le point d’entrée /metrics dans le Observability Insights API vous permet de récupérer par programmation des données de mesure pour l’activité de votre organisation dans Experience Platform.

NOTE
La version précédente du point d’entrée des mesures (V1) a été abandonnée. Ce document se concentre exclusivement sur la version actuelle (V2). Pour plus d’informations sur le point d’entrée V1 pour les implémentations héritées, reportez-vous à la référence API.

Prise en main

Le point d’entrée dʼAPI utilisé dans ce guide fait partie de lʼ Observability Insights API. Avant de continuer, consultez le guide de prise en main pour obtenir des liens vers la documentation associée, un guide de lecture des exemples dʼappels API dans ce document et des informations importantes sur les en-têtes requis pour réussir des appels à nʼimporte quel API dʼExperience Platform.

Récupération des mesures d’observabilité

Vous pouvez récupérer les données de mesure en adressant une requête POST au point d’entrée /metrics, en spécifiant les mesures que vous souhaitez récupérer dans la payload.

Format d’API

POST /metrics

Requête

curl -X POST \
  https://platform.adobe.io/data/infrastructure/observability/insights/metrics \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'x-sandbox-id: {SANDBOX_ID}'
  -d '{
        "start": "2020-07-14T00:00:00.000Z",
        "end": "2020-07-22T00:00:00.000Z",
        "granularity": "day",
        "metrics": [
          {
            "name": "timeseries.ingestion.dataset.recordsuccess.count",
            "filters": [
              {
                "name": "dataSetId",
                "value": "5edcfb2fbb642119194c7d94|5eddb21420f516191b7a8dad",
                "groupBy": true
              }
            ],
            "aggregator": "sum"
          },
          {
            "name": "timeseries.ingestion.dataset.dailysize",
            "filters": [
              {
                "name": "dataSetId",
                "value": "5eddb21420f516191b7a8dad",
                "groupBy": false
              }
            ],
            "aggregator": "sum",
          }
        ]
      }'
Propriété
Description
start
Date/heure au plus tôt à partir de laquelle récupérer les données de mesure.
end
Date/heure la plus récente à partir de laquelle récupérer les données de mesure.
granularity
Champ facultatif qui indique l’intervalle de temps selon lequel diviser les données de mesure. Par exemple, une valeur de DAY renvoie des mesures pour chaque jour entre la date de start et la date de end, tandis qu’une valeur de MONTH regroupe les résultats des mesures par mois à la place.
metrics
Tableau d’objets, un pour chaque mesure à récupérer.
name
Nom d’une mesure reconnue par Observability Insights. Consultez la annexe pour obtenir une liste complète des noms de mesures acceptés.
filters

Champ facultatif qui vous permet de filtrer les mesures en fonction de jeux de données spécifiques. Le champ est un tableau d’objets (un pour chaque filtre), chaque objet contenant les propriétés suivantes :

  • name : type d’entité en fonction de laquelle filtrer les mesures. Actuellement, seul dataSets est pris en charge.
  • value : identifiant d’un ou de plusieurs jeux de données. Plusieurs identifiants de jeu de données peuvent être fournis sous la forme d’une seule chaîne, chaque identifiant étant séparé par des caractères à barres verticales (|).
  • groupBy : lorsqu’elle est définie sur true, indique que la value correspondante représente plusieurs jeux de données dont les résultats de mesure doivent être renvoyés séparément. Si la valeur est false, les résultats des mesures pour ces jeux de données sont regroupés.
aggregator
Spécifie la fonction d'agrégation qui doit être utilisée pour regrouper plusieurs enregistrements de séries multiples en résultats uniques. Les agrégateurs actuellement pris en charge sont min, max, somme et moyenne en fonction de la définition de la mesure.

Réponse

Une réponse réussie renvoie les points de données obtenus pour les mesures et les filtres spécifiés dans la requête.

{
  "metricResponses": [
    {
      "metric": "timeseries.ingestion.dataset.recordsuccess.count",
      "filters": [
        {
          "name": "dataSetId",
          "value": "5edcfb2fbb642119194c7d94|5eddb21420f516191b7a8dad",
          "groupBy": true
        }
      ],
      "datapoints": [
        {
          "groupBy": {
            "dataSetId": "5edcfb2fbb642119194c7d94"
          },
          "dps": {
            "2020-07-14T00:00:00Z": 44.0,
            "2020-07-15T00:00:00Z": 46.0,
            "2020-07-16T00:00:00Z": 36.0,
            "2020-07-17T00:00:00Z": 50.0,
            "2020-07-18T00:00:00Z": 38.0,
            "2020-07-19T00:00:00Z": 40.0,
            "2020-07-20T00:00:00Z": 42.0,
            "2020-07-21T00:00:00Z": 42.0,
            "2020-07-22T00:00:00Z": 50.0
          }
        },
        {
          "groupBy": {
            "dataSetId": "5eddb21420f516191b7a8dad"
          },
          "dps": {
            "2020-07-14T00:00:00Z": 44.0,
            "2020-07-15T00:00:00Z": 46.0,
            "2020-07-16T00:00:00Z": 36.0,
            "2020-07-17T00:00:00Z": 50.0,
            "2020-07-18T00:00:00Z": 38.0,
            "2020-07-19T00:00:00Z": 40.0,
            "2020-07-20T00:00:00Z": 42.0,
            "2020-07-21T00:00:00Z": 42.0,
            "2020-07-22T00:00:00Z": 50.0
          }
        }
      ],
      "granularity": "DAY"
    },
    {
      "metric": "timeseries.ingestion.dataset.dailysize",
      "filters": [
        {
          "name": "dataSetId",
          "value": "5eddb21420f516191b7a8dad",
          "groupBy": false
        }
      ],
      "datapoints": [
        {
          "groupBy": {},
          "dps": {
            "2020-07-14T00:00:00Z": 38455.0,
            "2020-07-15T00:00:00Z": 40213.0,
            "2020-07-16T00:00:00Z": 31476.0,
            "2020-07-17T00:00:00Z": 43705.0,
            "2020-07-18T00:00:00Z": 33227.0,
            "2020-07-19T00:00:00Z": 34977.0,
            "2020-07-20T00:00:00Z": 36735.0,
            "2020-07-21T00:00:00Z": 36737.0,
            "2020-07-22T00:00:00Z": 43715.0
          }
        }
      ],
      "granularity": "DAY"
    }
  ]
}
Propriété
Description
metricResponses
Tableau dont les objets représentent chacune des mesures spécifiées dans la requête. Chaque objet contient des informations sur la configuration du filtre et les données de mesure renvoyées.
metric
Nom de l’une des mesures fournies dans la requête.
filters
Configuration du filtre pour la mesure spécifiée.
datapoints
Tableau dont les objets représentent les résultats de la mesure et des filtres spécifiés. Le nombre d’objets dans le tableau dépend des options de filtre fournies dans la requête. Si aucun filtre n’a été fourni, le tableau ne contient qu’un seul objet qui représente tous les jeux de données.
groupBy
Si plusieurs jeux de données ont été spécifiés dans la propriété filter pour une mesure et que l’option groupBy a été définie sur true dans la requête, cet objet contient l’identifiant du jeu de données auquel la propriété dps correspondante s’applique.

Si cet objet apparaît vide dans la réponse, la propriété dps correspondante s’applique à tous les jeux de données fournis dans le tableau filters (ou à tous les jeux de données dans Experience Platform si aucun filtre n’a été fourni).
dps
Données renvoyées pour la mesure, le filtre et la période donnés. Chaque clé de cet objet représente un horodatage avec une valeur correspondante pour la mesure spécifiée. La période entre chaque point de données dépend de la valeur granularity spécifiée dans la requête.

Annexe

La section suivante contient des informations supplémentaires sur l’utilisation du point d’entrée /metrics.

Mesures disponibles available-metrics

Les tableaux suivants répertorient toutes les mesures exposées par Observability Insights, réparties par service Experience Platform. Chaque mesure comprend une description et un paramètre de requête d’identifiant accepté.

NOTE
Tous les paramètres de requête d’ID répertoriés sont facultatifs, sauf indication contraire.

Data Ingestion ingestion

Le tableau suivant décrit les mesures pour Adobe Experience Platform Data Ingestion. Les mesures en gras sont des mesures d’ingestion par flux.

Mesure Informations
Description
Paramètre de requête d’identifiant
timeseries.ingestion.dataset.size
Taille cumulée de toutes les données ingérées pour un jeu de données ou tous les jeux de données.
Identifiant du jeu de données
timeseries.ingestion.dataset.dailysize
Taille des données ingérées quotidiennement pour un jeu de données ou tous les jeux de données.
Identifiant du jeu de données
timeseries.ingestion.dataset.batchfailed.count
Nombre de lots échoués pour un jeu de données ou tous les jeux de données.
Identifiant du jeu de données
timeseries.ingestion.dataset.batchsuccess.count
Nombre de lots ingérés pour un jeu de données ou tous les jeux de données.
Identifiant du jeu de données
timeseries.ingestion.dataset.recordsuccess.count
Nombre d’enregistrements ingérés pour un jeu de données ou tous les jeux de données.
Identifiant du jeu de données
timeseries.data.collection.validation.category.presence.count
Nombre total de messages « présence » non valides pour un jeu de données ou tous les jeux de données.
Identifiant du jeu de données
timeseries.data.collection.inlet.total.messages.received
Nombre total de messages reçus pour un inlet de données ou tous les inlets de données.
ID d’entrée
timeseries.data.collection.inlet.total.messages.size.received
Taille totale des données reçues pour un inlet de données ou tous les inlets de données.
ID d’entrée
timeseries.data.collection.inlet.success
Nombre total d’appels HTTP réussis à un inlet de données ou tous les inlets de données.
ID d’entrée
timeseries.data.collection.inlet.failure
Nombre total d’appels HTTP échoués à un inlet de données ou tous les inlets de données.
ID d’entrée

Identity Service identity

Le tableau suivant décrit les mesures pour Adobe Experience Platform Identity Service.

Mesure Informations
Description
Paramètre de requête d’identifiant
timeseries.identity.dataset.recordsuccess.count
Nombre d’enregistrements écrits dans leur source de données par Identity Service, pour un jeu de données ou tous les jeux de données.
Identifiant du jeu de données
timeseries.identity.dataset.recordfailed.count
Nombre d’enregistrements ayant échoué par Identity Service, pour un jeu de données ou pour tous les jeux de données.
Identifiant du jeu de données
timeseries.identity.dataset.namespacecode.recordskipped.count
Nombre d’enregistrements d’identité ignorés.
ID d’organisation
timeseries.identity.graph.imsorg.uniqueidentities.count
Nombre d’identités uniques stockées dans le graphique d’identités pour votre organisation.
N/A
timeseries.identity.graph.imsorg.namespacecode.uniqueidentities.count
Nombre d’identités uniques stockées dans le graphique d’identités pour un espace de noms.
Identifiant d’espace de noms (obligatoire)
timeseries.identity.graph.imsorg.graphstrength.uniqueidentities.count
Nombre d’identités uniques stockées dans le graphique d’identités de votre organisation pour une force de graphique particulière (« inconnue », « faible » ou « forte »).
Force de graphique (obligatoire)

Real-Time Customer Profile profile

Le tableau suivant décrit les mesures pour Real-Time Customer Profile.

Mesure Informations
Description
Paramètre de requête d’identifiant
timeseries.profiles.dataset.recordread.count
Nombre d’enregistrements lus depuis le Data Lake par Profile, pour un jeu de données ou pour tous les jeux de données.
Identifiant du jeu de données
timeseries.profiles.dataset.recordsuccess.count
Nombre d’enregistrements écrits dans leur source de données par Profile, pour un jeu de données ou pour tous les jeux de données.
Identifiant du jeu de données
timeseries.profiles.dataset.batchsuccess.count
Nombre de lots de Profile ingérés pour un jeu de données ou pour tous les jeux de données.
Identifiant du jeu de données

Messages d’erreur

Les réponses du point d’entrée /metrics peuvent renvoyer des messages d’erreur dans certaines conditions. Ces messages d’erreur sont renvoyés au format suivant :

{
    "type": "http://ns.adobe.com/aep/errors/INSGHT-1000-400",
    "title": "Bad Request - Start date cannot be after end date.",
    "status": 400,
    "report": {
        "tenantInfo": {
            "sandboxName": "prod",
            "sandboxId": "49f58060-5d47-34rd-aawf-a5384333ff12",
            "imsOrgId": "{ORG_ID}"
        },
        "additionalContext": null
    },
    "error-chain": [
        {
            "serviceId": "INSGHT",
            "errorCode": "INSGHT-1000-400",
            "invokingServiceId": "INSGHT",
            "unixTimeStampMs": 1602095177129
        }
    ]
}
Propriété
Description
title
Chaîne contenant le message d’erreur et la raison potentielle pour laquelle il a pu s’être produit.
report
Contient des informations contextuelles sur l’erreur, y compris le sandbox et l’organisation utilisés dans l’opération qui l’a déclenchée.

Le tableau suivant répertorie les différents codes d’erreur qui peuvent être renvoyés par l’API :

Code d’erreur
Titre
Description
INSGHT-1000-400
Payload de requête incorrecte

Un problème est survenu avec la payload de requête. Assurez-vous de correspondre exactement au formatage de la payload comme illustré ci-dessus. L’une des raisons possibles peut déclencher cette erreur :

  • Champs obligatoires manquants, tels que aggregator
  • Mesures non valides
  • La requête contient un agrégateur non valide
  • Une date de début se situe après une date de fin
  • La requête a une période (entre les dates de début et de fin) de plus de 32 jours
INSGHT-1001-400
Échec de la requête de mesures
Une erreur s’est produite lors de la tentative d’interrogation de la base de données de mesures en raison d’une requête incorrecte ou de l’impossibilité d’analyser la requête elle-même. Assurez-vous que la requête est correctement formatée avant de réessayer.
INSGHT-1001-500
Échec de la requête de mesures
Une erreur s’est produite lors de la tentative d’interrogation de la base de données de mesures en raison d’une erreur de serveur. Effectuez à nouveau la requête et si le problème persiste, contactez l’assistance Adobe.
INSGHT-1002-500
Erreur de service
La demande n’a pas pu être traitée en raison d’une erreur interne. Effectuez à nouveau la requête et si le problème persiste, contactez l’assistance Adobe.
INSGHT-1003-401
Erreur de validation du sandbox
La demande n’a pas pu être traitée en raison d’une erreur de validation du sandbox. Assurez-vous que le nom du sandbox que vous avez fourni dans l’en-tête x-sandbox-name représente un sandbox valide et activé pour votre organisation avant de réessayer la requête.
recommendation-more-help
d82ad670-3501-465b-afee-a91200fdc02c