Estensione Google Stackdriver Logging

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info

Versione 1.2.1

Scrivi voci nei log di Stackdriver Logging.

Questi contenuti forniscono un riferimento per la configurazione e l'utilizzo di questa estensione.

Prerequisiti

Prima di utilizzare questa estensione da un proxy API, devi:

1. In IAM, assegna l'autorizzazione Logging > Scrittore di log al membro del progetto che rappresenterà l'estensione nel sistema Stackdriver Logging. Per istruzioni su come concedere i ruoli, vedi Concedere ruoli a un account di servizio per risorse specifiche. Per saperne di più sui ruoli di accesso, consulta la Guida al controllo degli accessi.

2. Utilizza la console Google Cloud per generare una chiave per l'account di servizio.

3. Utilizza i contenuti del file JSON della chiave risultante quando aggiungi e configuri l'estensione utilizzando il riferimento alla configurazione.

Informazioni su Stackdriver Logging

Stackdriver Logging fa parte della suite di prodotti Stackdriver in Google Cloud (GCP). Include spazio di archiviazione per i log, un'interfaccia utente chiamata visualizzatore log e un'API per la gestione dei log a livello di programmazione. Con Stackdriver Logging puoi leggere e scrivere voci di log, eseguire ricerche e applicare filtri nei log, esportare i log e creare metriche basate su log.

Al momento questa estensione scrive voci nel log.

Per saperne di più, consulta la documentazione di Stackdriver Logging.

Esempi

Gli esempi riportati di seguito mostrano come configurare il supporto per le azioni di estensione di Stackdriver Logging utilizzando il criterio ExtensionCallout.

Log globale

Il seguente criterio scrive il messaggio "Questo è un test" in un log denominato example-log nella risorsa globale Stackdriver. In uso effettivo, probabilmente il messaggio sarà contenuto in una variabile di flusso il cui valore viene 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 un riferimento per la configurazione e l'utilizzo di questa estensione. Per la procedura di configurazione di un'estensione utilizzando la console Apigee, vedi Aggiunta e configurazione di un'estensione.

Azioni

log

Scrive un messaggio nel log.

Questa azione scrive una voce di log di Stackdriver. Le voci di log sono costituite da metadati e dati delle voci. Per saperne di più 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.

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "stackdriver-log-name-to-use",
  "metadata" : JSON-structured-metadata,
  "message" : "data-to-log-as-entry"
}]]></Input>

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "example-log",
  "metadata" : { "resource" : { "type" : "global" } },
  "message": "This is a test."
}]]></Input>

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "example-log",
  "metadata" : { "resource" : { "type" : "global" } },
  "message" : { "info" :  "This is a test." }
}]]></Input>

Parametri di richiesta

Risposta

Nessuno se il messaggio è stato scritto nel log. In caso contrario, la richiesta restituirà un errore. Consulta anche Eseguire il debug di un'estensione.

Riferimento alla configurazione

Utilizza quanto segue quando configuri ed esegui il deployment di questa estensione per utilizzarla nei proxy API.

Proprietà comuni delle estensioni

Per ogni estensione sono presenti le seguenti proprietà.

Proprietà per questo pacchetto di estensioni

Specifica i valori per le seguenti proprietà di configurazione specifiche di questa estensione.