Endpoint "metrics"
Le metriche di osservabilità forniscono informazioni approfondite sulle statistiche di utilizzo, le tendenze storiche e gli indicatori di prestazioni per varie funzioni di Adobe Experience Platform. Il /metrics
endpoint nella Observability Insights API consente di recuperare in modo programmatico i dati delle metriche per l’attività dell’organizzazione in Platform.
Introduzione
L’endpoint API utilizzato in questa guida fa parte del Observability Insights API. Prima di continuare, controlla guida introduttiva per collegamenti alla documentazione correlata, una guida per la lettura delle chiamate API di esempio di questo documento e informazioni importanti sulle intestazioni richieste necessarie per effettuare correttamente le chiamate a Experience Platform API.
Recuperare le metriche di osservabilità
Per recuperare i dati delle metriche, devi effettuare una richiesta POST al /metrics
, specificando le metriche da recuperare nel payload.
Formato API
POST /metrics
Richiesta
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}' \
-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",
"downsample": "sum"
},
{
"name": "timeseries.ingestion.dataset.dailysize",
"filters": [
{
"name": "dataSetId",
"value": "5eddb21420f516191b7a8dad",
"groupBy": false
}
],
"aggregator": "sum",
"downsample": "sum"
}
]
}'
start
end
granularity
DAY
restituisce le metriche per ogni giorno compreso tra start
e end
data, mentre un valore di MONTH
raggrupperebbe invece i risultati delle metriche per mese. Quando si utilizza questo campo, viene visualizzata una downsample
deve essere fornita anche una proprietà per indicare la funzione di aggregazione mediante la quale raggruppare i dati.metrics
name
filters
Campo facoltativo che consente di filtrare le metriche per set di dati specifici. Il campo è un array di oggetti (uno per ciascun filtro), con ogni oggetto contenente le seguenti proprietà:
name
: tipo di entità su cui filtrare le metriche. Attualmente, solodataSets
è supportato.value
: ID di uno o più set di dati. È possibile fornire più ID di set di dati come una singola stringa, con ogni ID separato da caratteri di barra verticali (|
).groupBy
: se impostato su true, indica che il valorevalue
rappresenta più set di dati i cui risultati delle metriche devono essere restituiti separatamente. Se impostato su false, i risultati delle metriche per tali set di dati sono raggruppati.
aggregator
downsample
granularity
proprietà. Per informazioni dettagliate sul downsampling, fare riferimento al Documentazione di OpenTSDB.Risposta
In caso di esito positivo, la risposta restituisce i punti dati risultanti per le metriche e i filtri specificati nella richiesta.
{
"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"
}
]
}
metricResponses
metric
filters
datapoints
groupBy
filter
per una metrica e il groupBy
è stata impostata su true nella richiesta, questo oggetto conterrà l’ID del set di dati che il corrispondente dps
si applica a.Se questo oggetto appare vuoto nella risposta, il corrispondente
dps
si applica a tutti i set di dati forniti in filters
array (o tutti i set di dati in Platform se non sono stati forniti filtri).dps
granularity
valore specificato nella richiesta.Appendice
La sezione seguente contiene informazioni aggiuntive sull'utilizzo di /metrics
endpoint.
Metriche disponibili available-metrics
Nelle tabelle seguenti sono elencate tutte le metriche esposte da Observability Insights, suddivisi per Platform servizio. Ogni metrica include una descrizione e un parametro di query dell’ID accettato.
Data Ingestion ingestion
La tabella seguente illustra le metriche per Adobe Experience Platform Data Ingestion. Metriche in grassetto sono metriche di acquisizione in streaming.
Identity Service identity
La tabella seguente illustra le metriche per Adobe Experience Platform Identity Service.
Real-Time Customer Profile profile
La tabella seguente illustra le metriche per Real-Time Customer Profile.
Messaggi di errore
Risposte da /metrics
l’endpoint può restituire messaggi di errore in determinate condizioni. Questi messaggi di errore vengono restituiti nel seguente formato:
{
"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
}
]
}
title
report
Nella tabella seguente sono elencati i diversi codici di errore che possono essere restituiti dall’API:
INSGHT-1000-400
Si è verificato un errore nel payload della richiesta. Assicurati di applicare la formattazione del payload esattamente come mostrato sopra. Questo errore può essere attivato da uno dei motivi seguenti:
- Campi obbligatori mancanti come
aggregator
- Metriche non valide
- La richiesta contiene un aggregatore non valido
- Una data di inizio segue una data di fine
INSGHT-1001-400
INSGHT-1001-500
INSGHT-1002-500
INSGHT-1003-401
x-sandbox-name
prima di riprovare, l’intestazione rappresenta una sandbox valida e abilitata per la tua organizzazione.