Ottenere informazioni sulle chiamate alle tue API

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Questa pagina descrive come ottenere informazioni sulle chiamate alle tue API, tra cui:

• Il numero totale di chiamate effettuate a tutte le API.
• L'importo totale dei dati elaborati da tutte le API.

Queste informazioni possono aiutarti a valutare il tuo livello di abbonamento Apigee, come descritto in Diritti di abbonamento.

Nota:per effettuare le chiamate API descritte di seguito, devi disporre dell'autorizzazione apigee.environments.getStats. Per scoprire quali ruoli Apigee dispongono di questa autorizzazione, vedi Ruoli Apigee.

Numero totale di chiamate effettuate a tutte le API

Per trovare il numero totale di chiamate effettuate a tutte le API in una singola organizzazione e in un singolo ambiente per un determinato intervallo di tempo, utilizza una chiamata API Metrics simile a quella mostrata di seguito. Il risultato tiene conto degli scenari in cui hai concatenato proxy a catena.

curl -v "https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/stats/?select=sum(message_count)&timeRange=03/01/2023+00:00~03/31/2023+23:59" \
-H "Authorization: Bearer $TOKEN"

Nella chiamata precedente:

• ORG è l'organizzazione.
• ENV è l'ambiente.
• timeRange è l'intervallo di tempo per il report, nel formato MM/DD/YYYY+HH:MM~MM/DD/YYYY+HH:MM, dove la data e l'ora di inizio e la data e l'ora di fine sono nel formato MM/DD/YYYY+HH:MM.
• $TOKEN è una variabile di ambiente impostata sul tuo token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso OAuth 2.0. Per informazioni sulle opzioni curl utilizzate in questo esempio, consulta la sezione Utilizzare curl.

Nota:per trovare il numero totale di chiamate effettuate alle tue API, devi ripetere la chiamata precedente per tutti i tuoi ambienti e le tue organizzazioni.

Di seguito è riportato un esempio di risposta alla chiamata precedente:

{
  "environments": [
    {
      "metrics": [
        {
          "name": "sum(message_count)",
          "values": [
            "7.44944088E8"
          ]
        }
      ],
      "name": "prod"
    }
  ],
...
}

Il campo values della risposta contiene il numero di chiamate effettuate alle API nell'organizzazione e nell'ambiente nell'intervallo di tempo specificato.

Quantità totale di dati elaborati da tutte le API

Per trovare la quantità totale di dati elaborati da tutte le API in una singola organizzazione e ambiente per un determinato intervallo di tempo, utilizza due chiamate: una per i dati delle richieste e un'altra per i dati delle risposte.

Nota:il totale include le dimensioni dei dati del payload nelle chiamate, ma non le dimensioni dell'intestazione.

Per trovare la quantità totale di dati delle richieste, utilizza una chiamata simile alla seguente:

curl -v "https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/stats/?select=sum(request_size)&timeRange=03/01/2023+00:00~03/31/2023+23:59" \
-H "Authorization: Bearer $TOKEN"

Per trovare i dati di risposta all'importo totale, utilizza una chiamata simile alla seguente:

curl -v "https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/stats/?select=sum(response_size)&timeRange=03/01/2023+00:00~03/31/2023+23:59" \
-H "Authorization: Bearer $TOKEN"

Le variabili in queste chiamate sono le stesse dell'esempio precedente.

Nota:per trovare la quantità totale di dati elaborati dalle tue API, devi ripetere le chiamate precedenti per tutti i tuoi ambienti e le tue organizzazioni.

Nota sul concatenamento dei proxy

Se un ambiente contiene più proxy concatenati, una singola chiamata a uno dei proxy verrà inoltrata agli altri proxy della catena. In questo modo, aumenta il conteggio totale delle chiamate API e la quantità totale di dati elaborati da tutte le chiamate API. I comandi che restituiscono queste informazioni, mostrati nelle sezioni precedenti, tengono conto del concatenamento dei proxy.