Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Versione 1.3.7
Scrivi le voci nei log di Stackdriver Logging.
Questi contenuti forniscono riferimento per la configurazione e l'utilizzo di questa estensione.
Prerequisiti
Prima di utilizzare questa estensione da un proxy API, devi:
In IAM, assegna i ruoli Logging > Writer log e Logging > Visualizzatore log al membro del progetto che rappresenterà l'estensione nel sistema Stackdriver Logging. Per istruzioni su come concedere i ruoli, vedi Concessione di ruoli a un account di servizio per risorse specifiche. Per ulteriori informazioni sui ruoli di logging, consulta la guida al controllo dell'accesso.
Utilizza la console di Google Cloud per generare una chiave per l'account di servizio.
Utilizza i contenuti del file JSON della chiave risultante durante l'aggiunta e la configurazione dell'estensione utilizzando il riferimento di configurazione.
Questa estensione supporta le chiamate da parte delle norme ExtensionCallout che si trovano in PostClientFlow.
Se vuoi utilizzare il criterio ExtensionCallout per chiamare questa estensione da un
PostClientFlow, assicurati che il flag features.allowExtensionsInPostClientFlow
sia impostato su true
nella tua organizzazione.
Se sei un cliente Apigee Edge per il cloud pubblico, devi contattare l'assistenza Apigee Edge per assicurarti che il flag
features.allowExtensionsInPostClientFlow
sia impostato sutrue
nella tua organizzazione.Se sei un cliente Apigee Edge per il cloud privato, utilizza l'API Aggiorna proprietà organizzazione per impostare il flag
features.allowExtensionsInPostClientFlow
sutrue
.
Informazioni su Stackdriver Logging
Stackdriver Logging fa parte della suite di prodotti Stackdriver in Google Cloud Platform (GCP). Include spazio di archiviazione per i log, un'interfaccia utente chiamata Visualizzatore log e un'API per la gestione dei log in modo programmatico. Con Stackdriver Logging puoi leggere e scrivere voci di log, cercare e filtrare i log, esportare i log e creare metriche basate su log.
Al momento questa estensione scrive le voci nel log. Per ulteriori informazioni, consulta la documentazione di Stackdriver Logging.
Samples
I seguenti esempi mostrano come configurare il supporto per le azioni dell'estensione Stackdriver Logging utilizzando i criteri estensioneCallout.
Log globale
Il criterio seguente scrive il messaggio "Questo è un test" in un log chiamato example-log nella risorsa Stackdriver Global. In uso, probabilmente il messaggio sarebbe contenuto in una variabile di flusso il cui valore hai impostato altrove nel proxy API.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Logging-Extension">
<DisplayName>Logging Connector</DisplayName>
<Connector>stackdriver-extension-sample</Connector>
<Action>log</Action>
<Input><![CDATA[{
"logName": "example-log",
"metadata": {
"resource": {
"type": "global",
"labels": {
"project_id": "my-test"
}
}
},
"message": "This is a test"
}]]></Input>
</ConnectorCallout>
Questi contenuti forniscono riferimento per la configurazione e l'utilizzo di questa estensione. Per i passaggi per configurare un'estensione utilizzando la console Apigee, consulta Aggiungere e configurare un'estensione.
Azioni
log
Scrive un messaggio nel log.
Questa azione scrive una voce di log Stackdriver. Le voci di log sono composte da metadati e dati di voce. Per ulteriori informazioni sulle voci di log, consulta la sezione Riferimento alle voci. Per informazioni sui contenuti della proprietà metadata
, consulta l'oggetto LogEntry nella documentazione di Stackdriver Logging.
Sintassi
<Action>log</Action>
<Input><![CDATA[{
"logName" : "stackdriver-log-name-to-use",
"metadata" : JSON-structured-metadata,
"message" : "data-to-log-as-entry"
}]]></Input>
Esempio
<Action>log</Action>
<Input><![CDATA[{
"logName" : "stackdriver-log-name-to-use",
"metadata" : { "resource" : { "type" : "global" } },
"message" : "data-to-log-as-entry"
}]]></Input>
Parametri richiesta
Parametro | Descrizione | Tipo | Predefinito | Obbligatorie |
---|---|---|---|---|
logName | Il nome del log a cui appartiene questa voce. | Stringa | Nessuna. | Sì. |
metadati | Metadati relativi alla voce di log. Per ulteriori informazioni e opzioni sull'impostazione di type e labels in metadata , consulta MonitoredResource. |
JSON | Nessuna. | N. |
messaggio | Dati da utilizzare come valore per questa voce di log. | Stringa | Nessuna. | Sì. |
Risposta
Nessuno se il messaggio è stato scritto nel log. In caso contrario, la richiesta restituirà un errore. Vedi anche Eseguire il debug di un'estensione.
Riferimento per la configurazione
Utilizza quanto segue durante la configurazione e il deployment di questa estensione per l'utilizzo nei proxy API.
Proprietà delle estensioni comuni
Per ogni estensione sono presenti le seguenti proprietà.
Proprietà | Descrizione | Predefinito | Obbligatorio |
---|---|---|---|
name |
Il nome che assegni a questa configurazione dell'estensione. | Nessuno | Sì |
packageName |
Nome del pacchetto dell'estensione fornito da Apigee Edge. | Nessuno | Sì |
version |
Numero di versione del pacchetto dell'estensione da cui stai configurando un'estensione. | Nessuno | Sì |
configuration |
Valore di configurazione specifico per l'estensione che stai aggiungendo. Vedi Proprietà per questo pacchetto di estensioni | Nessuno | Sì |
Proprietà per questo pacchetto di estensioni
Specifica i valori per le seguenti proprietà di configurazione specifiche di questa estensione.
Proprietà | Descrizione | Predefinito | Obbligatorie |
---|---|---|---|
projectId | L'ID progetto Google Cloud in cui devono essere creati i log. | Nessuna. | Sì. |
credenziali | Una volta inseriti nella console Apigee Edge, questi saranno i contenuti del file della chiave dell'account di servizio. Quando viene inviato tramite l'API di gestione, si tratta di un valore con codifica Base64 generato dal file della chiave dell'account di servizio. | Nessuna. | Sì. |