Extensão do Google Cloud Logging

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

Versão 1.6.1

Gravar entradas em registros do Cloud Logging.

Este conteúdo oferece referência para configurar e usar essa extensão.

Pré-requisitos

Antes de usar essa extensão de um proxy de API, você precisa:

1. No IAM, atribua o papel Logging > Gravador de registros ao membro do projeto que representará sua extensão para o sistema do Cloud Logging. Para instruções sobre como conceder papéis, consulte Como conceder papéis a uma conta de serviço para recursos específicos. Para saber mais sobre as funções de geração de registros, consulte o Guia de controle de acesso.

2. Gere uma chave para a conta de serviço com o console do Google Cloud.

3. Use o conteúdo do arquivo JSON da chave resultante ao adicionar e configurar a extensão com a referência de configuração.

Esta extensão pode ser chamada por uma política Extension callout localizada no PostClientFlow. Se você quiser usar a política ExtensionExtension para chamar essa extensão de um PostClientFlow, verifique se a sinalização features.allowExtensionsInPostClientFlow está definida como true na sua organização.

• Se você for cliente do Apigee Edge para nuvem pública, precisará entrar em contato com o suporte do Apigee Edge para garantir que a sinalização features.allowExtensionsInPostClientFlow esteja definida como true em sua organização.

• Se você for um cliente do Apigee Edge para nuvem privada, use a API Atualizar propriedades da organização para definir a sinalização features.allowExtensionsInPostClientFlow como true.

Sobre o Cloud Logging

O Cloud Logging faz parte do pacote de operações do Google Cloud. Ele inclui armazenamento para registros, uma interface do usuário chamada de Análise de registros e uma API para gerenciamento programático. Com o Cloud Logging, é possível ler e gravar entradas de registro, pesquisar, filtrar e exportar registros e criar métricas com base neles.

A extensão do Cloud Logging grava entradas no registro atualmente. Para mais informações, consulte os documentos do Cloud Logging.

Exemplos

Os exemplos a seguir ilustram como configurar o suporte para ações de extensão do Cloud Logging usando a política Extension callout.

Registro global

A política a seguir grava a mensagem This is a test em um registro chamado example-log no recurso global do Cloud. Em uso real, você provavelmente teria a mensagem contida em uma variável de fluxo com valor definido em outro lugar no proxy da 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>cloud-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>

Este conteúdo oferece referência para configurar e usar essa extensão. Para ver as etapas para configurar uma extensão usando o console da Apigee, consulte Como adicionar e configurar uma extensão.

Ações

log

Grava uma mensagem no registro.

Esta ação grava uma entrada de registro do Cloud Logging. As entradas de registro consistem em metadados e dados de entrada. Para saber mais sobre entradas de registro, consulte a Referência de entradas. Para informações sobre o conteúdo da propriedade metadata, consulte o objeto LogEntry na documentação do Cloud Logging.

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "cloud-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>

Parâmetros de solicitação

Resposta

None se a mensagem foi gravada no registro. Caso contrário, a solicitação retornará um erro. Consulte também Como depurar uma extensão.

Referência de configuração

Use o código a seguir ao configurar e implantar a extensão para uso em proxies de API.

Propriedades de extensão comuns

As propriedades a seguir estão presentes para cada extensão.

Propriedades deste pacote de extensão

Especifique valores para as propriedades de configuração a seguir específicas desta extensão.