Riferimento per metriche, dimensioni e filtri di analisi

Questa pagina si applica a Apigee e Apigee ibridi.

Visualizza documentazione di Apigee Edge.

Questo argomento fa riferimento alle metriche, alle dimensioni e ai filtri di Analytics. Per maggiori informazioni relative, consulta Panoramica di API Analytics.

Questo argomento mostra i nomi delle metriche e delle dimensioni così come vengono visualizzati nell'interfaccia utente e in base alle tue esigenze. per utilizzarle nelle chiamate API.

Metriche

Di seguito sono riportate le metriche API che puoi recuperare nei report personalizzati e nelle chiamate API Apigee.

Metrica Nome da utilizzare nell'API Apigee Funzioni Descrizione
Media di transazioni al secondo tps Nessuno

Numero medio di transazioni, ovvero richieste proxy API, al secondo. Tieni presente che se hai una soglia relativamente bassa numero di transazioni nel periodo di tempo, il numero medio di transazioni secondi potrebbe sembrare pari a zero nei report personalizzati dell'interfaccia utente se il numero è inferiore a due posizioni decimali.

Sintassi dell'API: tps

Successo della cache cache_hit somma

Numero di richieste API riuscite che utilizzano ResponseCache anziché la risposta desiderata dal servizio di destinazione.

Sintassi dell'API: sum(cache_hit)

Conteggio elementi cache L1 ax_cache_l1_count media, min, max

Numero di elementi nella cache L1 (in memoria) per transazione in una determinata periodo di tempo. Ad esempio, se scegli max per il periodo di un giorno e entro quel giorno il numero massimo di elementi nella cache è 12 per una transazione specifica. il conteggio sarà 12. Per avg, se ci sono tre transazioni nel periodo di tempo su cui esegui la query, con un numero di cache pari a 5, 6 e 7, la media è 6. L1 La cache è in memoria e non L2, come descritto in Cache interna.

Sintassi dell'API: avg(ax_cache_l1_count)

Errori dei criteri policy_error somma

Numero totale di errori del criterio nel periodo di tempo specificato.

In genere gli errori dei criteri si verificano in base alla progettazione. Ad esempio, il criterio VerifyApiKey genera un errore quando nella richiesta viene passata una chiave API non valida e viene applicato un criterio SpikeArrest genera un errore se il numero di chiamate API supera il limite definito nel criterio. Quindi... questa metrica è utile per trovare potenziali punti critici nelle API. Ad esempio: policy_error metriche, raggruppate in base alla dimensione developer_app, potrebbero aiutarti a scoprire Una chiave API o un token OAuth sono scaduti per una determinata app. o potresti scoprire che un proxy API specifico sta generando molti errori di criterio SpikeArrest, il che porta a scoprire che il limite di arresto dei picchi del proxy non tiene conto di un aumento del traffico generato dalle festività.

In Analytics viene registrato un errore relativo ai criteri solo se l'errore provoca un errore del proxy API. Ad esempio, se l'attributo continueOnError di un criterio è impostato su true, il proxy API continua a elaborare una richiesta anche se il criterio non funziona. In questo caso, in Analytics non viene registrato un errore di criterio.

La dimensione Nome norma in caso di errore (ax_execution_fault_policy_name) è utile per: gli errori dei criteri di raggruppamento per nome del criterio.

Un errore della destinazione (ad esempio 404 o 503) non viene conteggiato come un errore del criterio. Quelli vengono conteggiati come errori del proxy API (is_error).

Sintassi dell'API: sum(policy_error)

Errori del proxy is_error somma

Numero totale di errori dei proxy API nel periodo di tempo specificato. Proxy l'errore può verificarsi quando un criterio non riesce o si verifica un errore di runtime, ad esempio 404 o 503 dal servizio di destinazione.

La dimensione Proxy (apiproxy) è utile per raggruppare gli errori del proxy API per proxy.

Sintassi dell'API: sum(is_error)

Latenza di elaborazione delle richieste request_processing_latency media, min, max

Quantità di tempo (media, minima o massima), in millisecondi. necessaria per elaborare le richieste in entrata. L'ora inizia quando la richiesta raggiunge Apigee e termina quando Apigee inoltra la richiesta al servizio di destinazione.

Utilizzando dimensioni diverse, puoi esaminare le latenze di elaborazione delle richieste in base al proxy API, app sviluppatore, regione e così via.

Sintassi dell'API: max(request_processing_latency)

Dimensioni richiesta request_size somma, media, min, max

Dimensioni del payload della richiesta ricevuto da Apigee, in byte.

Sintassi dell'API: avg(request_size)

Cache delle risposte eseguita ax_cache_executed somma

Numero totale di volte in cui un criterio ResponseCache è stato eseguito nel periodo di tempo specificato punto.

Poiché il criterio ResponseCache è collegato in due posizioni in un proxy API (una volta e una nella risposta), di solito viene eseguita due volte in una chiamata API. Una cache GET e una cache PUT vengono conteggiate come un'esecuzione.

Tuttavia, l'esecuzione della cache di risposta è pari a 0 se <SkipCacheLookup> del criterio viene restituito come true (nella richiesta) e 0 se <SkipCachePopulation> del criterio restituisce true (nella risposta).

Nello strumento di debug, puoi fare clic sull'icona ResponseCache in una chiamata API eseguita e visualizzare responsecache.executed variabile di flusso in vedere se è stata eseguita o meno un'esecuzione della cache (valore 1).

Sintassi dell'API: sum(ax_cache_executed)

Latenza di elaborazione della risposta response_processing_latency media, min, max

Quantità di tempo (media, minima o massima), in millisecondi. ci vuole Apigee per elaborare le risposte dell'API. L'ora inizia quando il proxy API riceve la risposta del servizio di destinazione e termina quando Apigee inoltra la risposta all'originale chiamante.

Utilizzando dimensioni diverse, puoi esaminare le latenze di elaborazione delle risposte in base all'API proxy, regione e così via.

Sintassi dell'API: min(response_processing_latency)

Dimensione della risposta response_size somma, media, min, max

Dimensione del payload della risposta restituito al client, in byte.

Sintassi dell'API: max(response_size)

Errori di targeting target_error somma

Numero totale di risposte 5xx dal servizio di destinazione. Questi sono servizi di destinazione non causati da Apigee.

Sintassi dell'API: sum(target_error)

Tempo di risposta target target_response_time somma, media, min, max

Quantità di tempo (somma, media, minima o massima) in millisecondi, affinché il server di destinazione risponda a una chiamata. Questa metrica indica le prestazioni dei server di destinazione. L'ora inizia quando Apigee inoltra una richiesta al servizio di destinazione e termina quando Apigee riceve la risposta.

Tieni presente che se una chiamata API restituisce una risposta dalla cache (utilizzando ResponseCache ad esempio), la chiamata non raggiungerà mai il servizio di destinazione e nessun target vengono registrate le metriche del tempo di risposta.

Sintassi dell'API: avg(target_response_time)

Tempo di risposta totale total_response_time somma, media, min, max

Quantità di tempo (somma, media, minima o massima) in millisecondi, da quando Apigee riceve una richiesta da un client a quando Apigee invia la risposta al client. Il tempo include l'overhead di rete (ad esempio il tempo impiegato da bilanciatori del carico e router per svolgere il loro lavoro), le richieste di elaborazione latenza, latenza di elaborazione della risposta e tempo di risposta target (se la risposta viene pubblicata) dal servizio di destinazione anziché dalla cache).

Utilizzando dimensioni diverse, puoi esaminare le latenze di elaborazione per proxy API, app sviluppatore, regione e così via.

Sintassi dell'API: avg(total_response_time)

Traffico message_count somma

Numero totale di chiamate API elaborate da Apigee nel periodo di tempo specificato.

Utilizza le dimensioni per raggruppare i conteggi del traffico nel modo più significativo per te.

Sintassi dell'API: sum(message_count)

Monetizzazione
Tariffe fees somma, media, min, max

Importo che rappresenta la tariffa di configurazione, le tariffe ricorrenti o la ricarica prepagata.

Sintassi dell'API: sum(fees)

Quota di condivisione delle entrate degli sviluppatori x_apigee_mintng_dev_share somma, media, min, max

Quota dello sviluppatore nelle entrate di una transazione. Apigee calcola la quota di sviluppatore solo se hai abilitato la condivisione delle entrate nel tuo piano tariffario.

La quota dello sviluppatore viene calcolata utilizzando la seguente formula:

x_apigee_mintng_dev_share = revShareGrossPrice * (share percentage)

Il valore della percentuale di condivisione viene recuperato dal tuo piano tariffario.

Sintassi dell'API: sum(x_apigee_mintng_dev_share)

Prezzo della monetizzazione x_apigee_mintng_price somma, media, min, max

Entrate totali di una transazione. Le entrate di una transazione sono impostate sul valore della variabile di monetizzazione revShareGrossPrice acquisita nel criterio Data Capture.

Sintassi dell'API: sum(x_apigee_mintng_price)

Moltiplicatore di prezzi per le API x_apigee_mintng_price_multiplier somma, media, min, max

Il fattore (moltiplicatore) per cui il costo per transazione viene moltiplicato. Il costo per transazione è specificato nei prezzi delle tariffe basate sul consumo del piano tariffario.

Sintassi dell'API: avg(x_apigee_mintng_price_multiplier)

Percentuali di monetizzazione x_apigee_mintng_rate somma, media, min, max

Tariffa addebitata per una transazione. Il tasso addebitato per una transazione viene calcolato utilizzando la seguente formula:

x_apigee_mintng_rate = (consumption-based pricing rate) * perUnitPriceMultiplier value

Il valore della tariffa basata sul consumo viene recuperato dal piano tariffario e Il valore perUnitPriceMultiplier viene moltiplicato solo se la variabile viene acquisita dalla variabile Criterio Data Capture.

Sintassi dell'API: sum(x_apigee_mintng_rate)

Dimensioni

Le dimensioni ti consentono di visualizzare le metriche in raggruppamenti significativi. Ad esempio, visualizzare il traffico totale i conteggi diventano molto più efficaci quando li visualizzi per ogni app sviluppatore o proxy API.

Di seguito sono riportate le dimensioni predefinite fornite da Apigee.

Dimensioni Nome da utilizzare nell'API Apigee Descrizione
Token di accesso access_token Token di accesso OAuth dell'utente finale dell'app.
Prodotto API api_product
  • Nome del prodotto API contenente i proxy API chiamati. Per ottenere questa dimensione, le app degli sviluppatori che effettuano le chiamate devono essere associate a una o più API prodotti contenenti proxy API, che i proxy chiamati devono verificare chiave o token OAuth inviato con la chiamata API. La chiave o il token è associato a un'API prodotto. Per ulteriori informazioni, vedi Come faccio a generare dati di analisi completi?

    Se non vengono soddisfatti i criteri riportati sopra, viene visualizzato il valore (not set). Vedi anche Che cos'è il valore dell'entità di analisi "(not set)" significa?.

  • Nel contesto della metrica relativa alle tariffe, sarà il prodotto API corrispondente al piano tariffario. a cui deve essere applicata una tariffa di configurazione o una tariffa ricorrente. Il valore essere vuota per una ricarica prepagata.

Chiave cache ax_cache_key

Chiave contenente il valore ResponseCache a cui è stato eseguito l'accesso. Per ulteriori informazioni come è strutturata la chiave per la cache delle risposte, consulta il criterio ResponseCache.

Nello strumento di debug, quando selezioni un criterio ResponseCache che legge dalla cache o scrive nella cache, puoi vedere questo valore nella responsecache.cachekey variabile di flusso.

Nome cache ax_cache_name

Nome della cache contenente le chiavi/valori utilizzati dal criterio ResponseCache. con prefisso orgName__envName__. Ad esempio, se l'organizzazione è myorgf, il l'ambiente è test, con il nome della cache myCache il ax_cache_name è foo__test__myCache.

Nello strumento di debug, quando selezioni un criterio ResponseCache, puoi vedere questo valore nel responsecache.cachename variabile di flusso.

Origine cache ax_cache_source

Livello della cache (database L1 in memoria o L2) da cui ResponseCache è stato recuperato. Questa dimensione mostra anche CACHE_MISS quando la risposta è stata inviata da la destinazione anziché la cache (e la cache delle risposte è stata aggiornata con la risposta della destinazione); o quando una chiave cache nella richiesta non è valida. Le chiavi cache sono limitate a Deve avere una dimensione di 2 kB.

Nello strumento di debug, quando selezioni il criterio ResponseCache, puoi vedere questo valore nel responsecache.cachesource variabile di flusso.

Per ulteriori informazioni sui livelli della cache, consulta Interna della cache.

ID client client_id

Chiave utente (chiave API) dell'app sviluppatore che effettua le chiamate API, anche se passate nella richiesta come chiavi API o incluse nei token OAuth.

Per ottenere questa dimensione, i proxy che ricevono chiamate devono essere configurati per verificare per una chiave API o un token OAuth valido. Le app sviluppatore ricevono chiavi API, che possono essere utilizzate per e generare token OAuth quando le app sono registrate in Apigee. Per ulteriori informazioni, vedi Come faccio a generare dati di analisi completi?

Se non vengono soddisfatti i criteri riportati sopra, viene visualizzato il valore (not set). Consulta anche Che cosa rende il valore dell'entità di analisi "(not set)" significa?.

App sviluppatore developer_app

App per sviluppatori registrata Apigee che effettua chiamate API.

Per ottenere questa dimensione, le app devono essere associate a uno o più prodotti API contenenti i proxy API chiamati, che devono verificare la presenza di una chiave API o Token OAuth inviato con la chiamata API. La chiave o il token identifica l'app sviluppatore. Per Per ulteriori informazioni, consulta la sezione Come faccio a generare dati di analisi completi?.

Se non vengono soddisfatti i criteri riportati sopra, viene visualizzato il valore (not set). Consulta anche Che cosa rende il valore dell'entità di analisi "(not set)" significa?.

Email sviluppatore developer_email
  • Email degli sviluppatori registrati ad Apigee la cui app ha effettuato le chiamate API o L'ID AppGroup nel caso di un AppGroup.

    Per ottenere questa dimensione, gli sviluppatori o i gruppi di app devono avere app associate a uno o più Prodotti API che contengono i proxy API chiamati, che devono verificare la presenza di una Chiave API o token OAuth inviato con la chiamata API. La chiave o il token identifica lo sviluppatore dell'app. Per ulteriori informazioni, consulta Come faccio a generare dati di analisi completi?.

    Se non vengono soddisfatti i criteri riportati sopra, viene visualizzato il valore (not set). Consulta anche Che cosa rende il valore dell'entità di analisi "(not set)" significa?.

  • Nel contesto della metrica relativa alle tariffe, sarà lo sviluppatore a dover pagare l'importo costi di configurazione, costi ricorrenti o ricarica prepagata.
ID sviluppatore developer

ID sviluppatore univoco generato da Apigee sotto forma di org_name@@@unique_id.

Per ottenere questa dimensione, gli sviluppatori devono avere app associate a uno o più Prodotti API contenenti i proxy API chiamati, che devono verificare la presenza di Chiave API o token OAuth inviato con le chiamate API. La chiave o il token identifica sviluppatore. Per ulteriori informazioni, consulta Come faccio a generare dati di analisi completi?.

Se non vengono soddisfatti i criteri riportati sopra, viene visualizzato il valore (not set). Consulta anche Che cosa rende il valore dell'entità di analisi "(not set)" significa?.

Ambiente environment Ambiente Apigee in cui viene eseguito il deployment dei proxy API. Ad esempio, test o prod.
Codice di errore in caso di errore ax_edge_execution_fault_code

Il codice di errore dell'errore. Ad esempio: messaging.adaptors.http.flow.GatewayTimeout

Nome flusso in caso di errore ax_execution_fault
  _flow_name

Denominato flow in un proxy API che ha generato un errore. Ad esempio, PreFlow, PostFlow o il nome di un flusso condizionale che hai creato.

Tieni presente che il nome completo da utilizzare nell'API Apigee è ax_execution_fault_flow_name, senza interruzione di riga.

Dove non si sono verificati errori, viene visualizzato il valore (not set).

Risorsa di flusso flow_resource Utilizzo esclusivo di Apigee. Consulta Come utilizzare "Flusso di risorse" Dimensione in Analytics.
Stato del flusso in caso di errore ax_execution_fault
  _flow_state

Nome degli stati del flusso proxy API che hanno generato errori, ad esempio PROXY_REQ_FLOW o TARGET_RESP_FLOW.

Tieni presente che il nome completo da utilizzare nell'API Apigee è ax_execution_fault_flow_state, senza interruzione di riga.

ID flusso gateway gateway_flow_id Man mano che le chiamate API si spostano attraverso Apigee, ogni chiamata riceve il proprio ID flusso gateway. Esempio: rrt329ea-12575-114653952-1. L'ID flusso del gateway è utile per distinguere le metriche in Situazioni con TPS elevate in cui altre dimensioni come organizzazione, ambiente e timestamp sono identiche in tutte le chiamate.
Organizzazione organization Organizzazione Apigee in cui viene eseguito il deployment dei proxy API.
Nome del criterio in caso di errore ax_execution_fault
  _policy_name

Nome del criterio che ha generato un errore e causato l'esito negativo della chiamata API.

Tieni presente che il nome completo da utilizzare nell'API Apigee è ax_execution_fault_policy_name, senza interruzione di riga.

Se un criterio genera un errore, ma l'attributo principale del criterio continueOnError è impostato su true, il flusso del proxy API continua senza errori e il criterio l'errore non viene conteggiato in questa dimensione.

Proxy apiproxy Nome macchina (non il nome visualizzato) di un proxy API.
Percorso di base proxy proxy_basepath

BasePath configurato sul proxyEndpoint del proxy API. Il percorso di base non include il dominio e la porta dell'URL del proxy API. Ad esempio, se l'URL di base di un proxy API è https://apigeedocs-test.apigee.net/releasenotes/, il percorso di base è /releasenotes.

Il valore viene memorizzato anche nella variabile di flusso proxy.basepath.

Tipo di deployment proxy proxy_deployment_type

La Tipo di proxy API per i proxy di cui è stato eseguito il deployment. Se specifichi un tipo di proxy limita i risultati a quel tipo di proxy. I valori potenziali sono STANDARD, EXTENSIBLE o non impostato.

Suffisso percorso proxy proxy_pathsuffix

Percorso della risorsa aggiunto al percorso di base del proxy API. Ad esempio, se un proxy API L'URL di base è https://apigeedocs-test.apigee.net/hello/ e viene effettuata una chiamata a https://apigeedocs-test.apigee.net/hello/json, pathsuffix è /json.

Se non viene utilizzato pathsuffix, il valore è vuoto.

Il valore viene memorizzato anche nella variabile di flusso proxy.pathsuffix.

Revisione proxy apiproxy_revision Numero di revisione del proxy API che ha gestito le chiamate API. Ciò non corrisponde necessariamente indica l'ultima revisione di un proxy API. Se un proxy API ha 10 revisioni, l'8° è attualmente possibile eseguire il deployment della revisione. Inoltre, un'API può essere soggetta a più revisioni purché le revisioni abbiano percorsi di base diversi, come descritto in Deployment dei proxy.
IP client risolto ax_resolved_client_ip

Indirizzo IP del client di origine. Il valore dell'attributo ax_resolved_client_ip viene calcolata a partire dai valori in ax_true_client_ip e x_forwarded_for_ip dimensioni.

Tieni presente che quando utilizzi prodotti per il routing come Akamai per acquisire i veri indirizzi IP dei client, l'IP del client viene passato ad Apigee nell'intestazione HTTP True-Client-IP, che poi utilizzato per impostare la dimensione ax_true_client_ip.

Il valore della dimensione ax_resolved_client_ip viene calcolato come segue:

  1. Se ax_true_client_ip non è nullo e non contiene un indirizzo IP locale, quindi imposta ax_resolved_client_ip su ax_true_client_ip.
  2. In caso contrario, imposta ax_resolved_client_ip sul primo indirizzo IP non locale in x_forwarded_for_ip.
  3. Se sia ax_true_client_ip che x_forwarded_for_ip contengono IP locali, quindi imposta ax_resolved_client_ip sull'ultimo IP locale x_forwarded_for_ip.
  4. Se sia ax_true_client_ip sia x_forwarded_for_ip sono null, imposta ax_resolved_client_ip su (not set).
  5. Se ax_true_client_ip è un IP locale e x_forwarded_for_ip è nullo, imposta ax_resolved_client_ip su (not set).
Codice di stato della risposta response_status_code Codice di stato della risposta HTTP inoltrato da Apigee al client, ad esempio 200, 404 503 e così via. In Apigee, il codice di stato della risposta dalla destinazione può essere sovrascritto con come il criterioAssignMessage e il criterio RaiseFault, per questo motivo, questa dimensione può essere diversa dal Codice risposta target (target_response_code).
Host virtuale virtual_host Il nome dell'host virtuale Chiamata API effettuata. Per saperne di più, vedi Informazioni sugli ambienti e sui gruppi di ambienti.
In entrata/client
Indirizzo IP client client_ip Indirizzo IP del sistema che contatta il router, ad esempio il client originale. (proxy_client_ip) o su un bilanciatore del carico. Quando ci sono più IP nella X-Forwarded-For, questo è l'ultimo IP elencato.
Categoria dispositivo ax_ua_device_category Tipo di dispositivo da cui è stata effettuata la chiamata API, ad esempio Tablet o Smartphone.
Famiglia di sistemi operativi ax_ua_os_family Famiglia del sistema operativo del dispositivo che effettua la chiamata, ad esempio Android o iOS.
Versione sistema operativo ax_ua_os_version

La versione del sistema operativo del dispositivo che effettua la chiamata.

È utile utilizzarla come seconda dimensione di visualizzazione in dettaglio con la famiglia di sistemi operativi (ax_ua_os_family) per visualizzare le versioni dei sistemi operativi.

IP client proxy proxy_client_ip

Indirizzo IP del client chiamante, archiviato in proxy.client.ip variabile di flusso. Spesso si tratta dell'indirizzo X-Forwarded-For della chiamata in entrata, ovvero l'indirizzo IP ricevuto da Apigee dall'ultimo handshake TCP esterno. Questo potrebbe come client chiamante o come bilanciatore del carico. Quando ci sono più IP nella X-Forwarded-For, questo è l'ultimo IP elencato.

IP client di riferimento ax_true_client_ip

Quando utilizzi prodotti di routing come Akamai per acquisire i veri indirizzi IP dei client, gli IP dei client vengono passati ad Apigee nell'intestazione HTTP True-Client-IP. Questo acquisisce gli IP del client veri da quell'intestazione.

Per determinare l'indirizzo IP del client originale, a cui si accede tramite ax_resolved_client_ip , Apigee utilizza ax_true_client_ip e x_forwarded_for_ip dimensioni.

Percorso richiesta request_path

Percorso della risorsa (escluso il dominio) al servizio di destinazione, query esclusa parametri.

Ad esempio, il target di esempio Apigee http://mocktarget.apigee.net include diverse risorse, tra cui /user, che restituisce un saluto. Indipendentemente da come il proxy API chiama http://mocktarget.apigee.net/user, il valore di request_path è /user.

URI di richiesta request_uri

Percorso della risorsa (dominio escluso) al servizio di destinazione, inclusa la query parametri.

Ad esempio, il target di esempio Apigee http://mocktarget.apigee.net include varie risorse, tra cui /user?user={name} risorsa e query per restituire un saluto personalizzato al nome fornito. Indipendentemente dal modo in cui le API chiama http://mocktarget.apigee.net/user?user=Dude, il valore request_uri è /user?user=Dude.

Richiedi verbo request_verb Verbo di richiesta HTTP nelle richieste API, ad esempio GET, POST, PUT, DELETE.
User agent useragent

Nome dello user agent, o agente software, utilizzato per effettuare la chiamata API. Esempi:

  • Un Pixel XL che effettua una chiamata tramite Chrome: Mozilla/5.0 (Linux; Android 7.1.2; Pixel XL Build/NHG47N) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.92 Mobile Safari/537.36
  • Un iPad che effettua una chiamata tramite Chrome: Mozilla/5.0 (iPad; CPU OS 10_2 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) CriOS/54.0.2840.91 Mobile/14C92 Safari/602.1
  • cURL da un terminale: curl/7.51.0
Famiglia di user agent ax_ua_agent_family Famiglia dello user agent, ad esempio Chrome Mobile o curl.
Tipo di user agent ax_ua_agent_type Il tipo di user agent, ad esempio Browser, Mobile Browser, Library e così via.
Versione user agent ax_ua_agent_version

Versione dello user agent.

È utile utilizzarla come seconda dimensione di visualizzazione in dettaglio con Famiglia di user agent (ax_ua_agent_family) per ottenere la versione della famiglia di agenti.

In uscita/Destinazione
Target target Endpoint di destinazione che ha gestito la richiesta. Ad esempio, default.
Percorso di base target target_basepath

Percorso della risorsa (escluso il dominio) al servizio di destinazione, query esclusa definito nel parametro <TargetEndpoint> del proxy.

Ad esempio, supponiamo che un proxy API chiami il seguente target:

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

In questo esempio, il valore target_basepath è /user.

Se il target fosse questo:

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net</URL>
</HTTPTargetConnection>

target_basepath è nullo.

Nello strumento di debug, quando seleziona l'icona AX alla fine del diagramma di flusso, target.basepath La variabile di flusso viene mappata la dimensione target_basepath.

Nome servizio gRPC x_apigee_grpc_service_name Applicabile solo quando il servizio di destinazione è gRPC. Il nome del servizio gRPC. Per informazioni su gRPC per i proxy, consulta Creazione di proxy API gRPC.
Stato gRPC x_apigee_grpc_status Applicabile solo quando il servizio di destinazione è gRPC. Lo stato della richiesta gRPC. Per informazioni su gRPC per i proxy, consulta Creazione di proxy API gRPC.
Host di destinazione target_host Host del servizio di destinazione. Ad esempio, se un proxy API chiama http://mocktarget.apigee.net/help, il valore di target_host è mocktarget.apigee.net.
Indirizzo IP di destinazione target_ip Indirizzo IP del servizio di destinazione che restituisce la risposta al proxy API.
Codice di risposta target target_response_code

Codice di stato della risposta HTTP restituito dal servizio di destinazione al proxy API, come 200, 404, 503 e così via.

Il valore null indica che la richiesta non ha mai raggiunto il servizio di destinazione. Ciò si verifica quando La risposta viene fornita dal criterio ResponseCache o quando si verifica un errore nella richiesta. e l'elaborazione dei dati.

È diverso dal codice di stato della risposta (response_status_code).

Nome RPC gRPC x_apigee_grpc_rpc_name Applicabile solo quando il servizio di destinazione è gRPC. Il nome RPC. Per informazioni su gRPC per i proxy, consulta Creazione di proxy API gRPC.
URL di destinazione target_url

URL completo del servizio di destinazione definito nel TargetEndpoint di un proxy API.

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

In questo esempio, target_url è http://mocktarget.apigee.net/user?user=Dude.

Tieni presente che è possibile eseguire l'override dell'URL anche durante l'elaborazione proxy API con target.url variabile di flusso.

In proxy concatenamento, target_url nel proxy di chiamata è nullo.

Inoltro X per IP x_forwarded_for_ip

L'elenco di indirizzi IP nell'intestazione X-Forwarded-For.

Per determinare l'indirizzo IP del client originale, a cui si accede tramite ax_resolved_client_ip , Apigee utilizza ax_true_client_ip e x_forwarded_for_ip dimensioni.

X-Forwarded-For Proto x_forwarded_proto

Protocollo utilizzato dal client per connettersi al router. I valori validi includono http o https.

Ora
Giorno della settimana ax_day_of_week Abbreviazione di tre lettere del giorno della settimana in cui sono state effettuate le chiamate API. Per esempio Lun, Mar, Mer
Mese ax_month_of_year Il mese numerico in cui sono state effettuate le chiamate API. Ad esempio, 03 per marzo.
Ora del giorno ax_hour_of_day

In base al formato di 24 ore, l'ora a due cifre in cui sono state effettuate le chiamate API. Ad esempio: Chiamate API effettuate nell'ora tra le 22:00 e le 23:00, il valore di ax_hour_of_day è 22.

Il valore dell'ora è nel fuso orario UTC.

Fuso orario ax_geo_timezone Nomi comuni dei fusi orari da cui sono state effettuate le chiamate API, ad esempio America/New_York e Europe/Dublin.
Settimana del mese ax_week_of_month Settimana numerica del mese. Ad esempio, per le chiamate API effettuate durante la terza settimana di mese, il ax_week_of_month è 3.
Località
Città ax_geo_city Città da cui sono state effettuate le chiamate API.
Continente ax_geo_continent Codice di due lettere del continente da cui sono state effettuate le chiamate API. Ad esempio: NA per il Nord America.
Paese ax_geo_country Codice di due lettere del paese da cui sono state effettuate le chiamate API. Ad esempio, US per gli Stati Uniti.
Regione geografica ax_geo_region Codice sottolineato per la regione geografica, ad esempio STATE-COUNTRY. Ad esempio: WA-US per Washington-Stati Uniti.
Regione ax_dn_region Nome del data center Apigee in cui viene eseguito il deployment dei proxy API, ad esempio us-east-1.
Monetizzazione
Creato created

Attualmente disponibile nelle organizzazioni Apigee, non in organizzazioni ibride Apigee.

Timestamp Unix relativo all'aggiunta della pianificazione delle tariffe per lo sviluppatore di app e il prodotto API.

Tipo di commissioni fees_type Tipo di commissione. Può trattarsi di una tariffa di configurazione, di una tariffa ricorrente o di una ricarica prepagata. Questo valore viene compilato solo se hai selezionato la metrica Fees.
Valuta delle entrate x_apigee_mintng_currency
  • La valuta delle entrate da transazioni è impostata sul valore della variabile di monetizzazione currency acquisite nel criterio Data Capture. Questa valuta è associata alla valuta di revShareGrossPrice.
  • Nell'ambito della metrica relativa alle tariffe, sarà la valuta della tariffa di configurazione, della tariffa ricorrente o della ricarica prepagata.
ID piano tariffario x_apigee_mintng_rate_plan_id

Attualmente disponibile nelle organizzazioni Apigee, non in organizzazioni ibride di Apigee.

Il piano del tasso di monetizzazione per lo sviluppatore dell'app.

Transazione riuscita x_apigee_mintng_tx_success Lo stato di monetizzazione della transazione è impostato sul valore della variabile di monetizzazione transactionSuccess acquisita nella norma Data Capture.

Filtri

I filtri ti consentono di limitare i risultati alle metriche con caratteristiche specifiche. Di seguito sono riportati alcuni filtri di esempio. Quando definisci i filtri, utilizza nomi in stile API per le metriche e le dimensioni.

Restituisce le metriche per i proxy API con libri dei nomi o musica:

filter=(apiproxy in 'books','music')

Restituisce le metriche per i proxy API con nomi che iniziano con m:

filter=(apiproxy like 'm%')

Restituisce le metriche per i proxy API con nomi che non iniziano con m:

filter=(apiproxy not like 'm%')

Restituisce le metriche per le chiamate API con codici di stato della risposta compresi tra 400 e 599:

filter=(response_status_code ge 400 and response_status_code le 599)

Restituisce le metriche per le chiamate API con codice di stato della risposta 200 e codice di risposta target pari a 200 404:

filter=(response_status_code eq 200 and target_response_code eq 404)

Restituisce le metriche per le chiamate API con un codice di stato della risposta 500:

filter=(response_status_code eq 500)

Restituisce le metriche per le chiamate API che non hanno generato errori:

filter=(is_error eq 0)

Restituisce le metriche per le chiamate API che non hanno generato risposte di null:

filter=(response_status_code isnot null)

Di seguito sono riportati gli operatori che puoi utilizzare per creare filtri dei report.

Operatore Descrizione
in Includi nell'elenco
notin Escludi dall'elenco
is Utilizza response_status_code is null per filtrare in base alle risposte con codice di stato è null.
isnot Utilizza response_status_code isnot null per filtrare in base alle risposte con stato il codice non è null.
eq Uguale a ==
ne Non uguale a !=
gt Maggiore di >
lt Meno di <
ge Maggiore o uguale a >=
le Minore o uguale a <=
like Restituisce true se il pattern stringa corrisponde a quello fornito.
not like Restituisce false se il pattern stringa corrisponde al pattern fornito.
similar to Restituisce true o false a seconda che il suo pattern corrisponda alla stringa specificata. È simile a like, tranne per il fatto che interpreta il pattern utilizzando definizione di un'espressione regolare.
not similar to Restituisce false o true in base alla corrispondenza del pattern con la stringa specificata. È simile a not like, tranne per il fatto che interpreta il pattern utilizzando la definizione standard di un'espressione regolare.
and Consente di utilizzare la logica AND per includere più di un'espressione di filtro. Il filtro include dati che soddisfano tutte le condizioni.
or Consente di utilizzare la logica OR per valutare diverse possibili espressioni di filtro. Il filtro include i dati che soddisfano almeno una delle condizioni.