Configure a observabilidade dos microsserviços

Este documento contém as informações necessárias para configurar o plug-in de observabilidade de microsserviços, instrumentar as suas aplicações gRPC e obter informações do Cloud Monitoring, Cloud Logging e Cloud Trace.

Antes de começar

A observabilidade dos microsserviços funciona com qualquer implementação à qual tenha sido concedida autorização para aceder ao Cloud Monitoring, ao Cloud Logging e ao Cloud Trace ativando a API Microservices. Este guia fornece um exemplo de configuração da observabilidade de microsserviços através de um exemplo do Compute Engine.

A um nível elevado, faz o seguinte:

  1. Enquanto programador de serviços, ativa e controla o plug-in de observabilidade dos microsserviços.
  2. Enquanto operador de serviços, consome os dados recolhidos de várias formas.

Os repositórios gRPC (C++, Go e Java) incluem exemplos para demonstrar a observabilidade dos microsserviços.

Antes de configurar a observabilidade, conclua as seguintes tarefas:

  1. Leia a vista geral da observabilidade dos microsserviços.
  2. Certifique-se de que tem um projeto existente ou crie um novo projeto.
  3. Certifique-se de que tem uma conta de serviço existente ou crie uma nova.
  4. Leia acerca das duas variáveis de ambiente suportadas, decida qual usar e determine os valores exigidos pela variável de ambiente.
  5. Ative a API Microservices.

Escolha uma variável de ambiente de configuração

Quando ativa o plug-in de observabilidade de microsserviços, que é descrito em Instrumente as suas aplicações para o plug-in de observabilidade, tem de fornecer informações de configuração através de uma variável de ambiente. Por predefinição, não estão ativadas funcionalidades de observabilidade. Define a variável de ambiente na VM ou no contentor onde a aplicação ou a carga de trabalho gRPC está a ser executada.

Seguem-se as variáveis de ambiente:

  • GRPC_GCP_OBSERVABILITY_CONFIG_FILE: o valor é um caminho que aponta para um ficheiro de configuração codificado em JSON.
  • GRPC_GCP_OBSERVABILITY_CONFIG: o valor é o corpo da configuração codificado em JSON.

Se ambas as variáveis de ambiente estiverem definidas, GRPC_GCP_OBSERVABILITY_CONFIG_FILE tem prioridade sobre GRPC_GCP_OBSERVABILITY_CONFIG.

Para aplicar a configuração, tem de reiniciar a aplicação gRPC. Não pode definir nem ver os valores das variáveis de ambiente na Google Cloud consola.

Na configuração, pode definir um projeto de destino para o qual os dados de registo, rastreio e métricas são carregados. Define o ID do projeto no campo project_id.

Use as informações em Dados de configuração para definir os valores na variável de ambiente que escolher.

Ative a API Microservices

Pode usar a Google Cloud CLI ou a Google Cloud consola para ativar a API Microservices nos seus projetos. A ativação da API Microservice ativa automaticamente a API Cloud Logging, a API Cloud Monitoring e a API Cloud Trace.

Para ativar a API:

gcloud services enable microservices.googleapis.com

Defina autorizações de contas de serviço

Se estiver a usar uma conta de serviço não predefinida, conceda as autorizações necessárias para a conta de serviço. Defina os seguintes valores:

  • PROJECT_ID: substitua o ID do projeto.
  • SERVICE_ACCOUNT_NAME: substitua o nome da conta de serviço do seu projeto.
gcloud projects add-iam-policy-binding PROJECT_ID \
  --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
  --role=roles/logging.logWriter

gcloud projects add-iam-policy-binding PROJECT_ID> \
  --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
  --role=roles/monitoring.metricWriter

gcloud projects add-iam-policy-binding PROJECT_ID \
  --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
  --role=roles/cloudtrace.agent

Capacite as suas aplicações com instrumentos para o plug-in de observabilidade

Para instrumentar as suas aplicações de modo a que possam usar o plugin de observabilidade de microsserviços, use as seguintes instruções para C++, Java e Go.

C++

Pode usar C++ com a observabilidade de microsserviços a partir do gRPC C++ v1.54. O repositório de exemplo está no GitHub.

Alterações de compilação

O apoio técnico de observabilidade só está disponível através do sistema de compilação do Bazel. Adicione o destino grpcpp_gcp_observability como uma dependência.

Alterações de código necessárias

A ativação da observabilidade dos microsserviços requer uma dependência adicional (um módulo de observabilidade) e as seguintes alterações de código aos clientes, servidores ou ambos os gRPC existentes:

#include <grpcpp/ext/gcp_observability.h>

int main(int argc, char** argv) {
  auto observability = grpc::GcpObservability::Init();
  assert(observability.ok());
  …
  // Observability data flushed when object goes out of scope
}

Antes de quaisquer operações gRPC, incluindo a criação de um canal, um servidor ou credenciais, invoque o seguinte:

grpc::GcpObservability::Init();

Isto devolve absl::StatusOr<GcpObservability>, que deve ser guardado. O estado ajuda a determinar se a observabilidade foi inicializada com êxito. O objeto GcpObservability que acompanha controla a duração total da observabilidade e fecha e limpa automaticamente os dados de observabilidade quando sai do âmbito.

Ir

Os plug-ins de observabilidade de microsserviços são suportados para versões do gRPC Go v1.54.0 e posteriores. O repositório de exemplo está no GitHub.

Com o módulo Go, a ativação da observabilidade dos microsserviços requer um módulo de observabilidade e o seguinte código:

import "google.golang.org/grpc/gcp/observability"

func main() {
       ctx, cancel := context.WithTimeout(context.Background(), time.Second)
       defer cancel()
       if err := observability.Start(ctx); err != nil {
              log.Warning("Unable to start gRPC observability:", err)
       }
       defer observability.End()
       …
}

A chamada observability.Start analisa a configuração das variáveis de ambiente, cria exportadores em conformidade e injeta lógica de recolha nas ligações de clientes e nos servidores criados após a chamada. A chamada adiadaobservability.End limpa os recursos e garante que os dados em buffer são descarregados antes de a aplicação ser fechada.

Depois de atualizar o código da aplicação, execute o seguinte comando para atualizar o ficheiro go.mod.

go mod tidy

Java

Para usar a observabilidade de microsserviços com aplicações Java, modifique a compilação para incluir o artefacto grpc-gcp-observability. Use a versão 1.54.1 ou posterior do gRPC.

Nas secções de criação de fragmentos nas ferramentas de criação do Gradle e Maven, o valor de grpcVersion é 1.54.1.

O repositório de exemplo está no GitHub.

Alterações necessárias ao código Java

Para instrumentar com êxito as suas aplicações Java para observabilidade de microsserviços, adicione o seguinte código a main().

...
import io.grpc.gcp.observability.GcpObservability;
...

// Main application class
...

public static void main(String[] args) {
...
   // call GcpObservability.grpcInit() to initialize & get observability
   GcpObservability observability = GcpObservability.grpcInit();

...
   // call close() on the observability instance to shutdown observability
   observability.close();
...
}

Tenha em atenção que tem de chamar GcpObservability.grpcInit() antes de serem criados canais gRPC ou servidores. A função GcpObservability.grpcInit() lê a configuração de observabilidade dos microsserviços e usa-a para configurar os interceptores e os rastreadores globais necessários para a funcionalidade de registo, métricas e rastreio em cada canal e servidor criado. GcpObservability.grpcInit() é thread-safe e tem de ser chamado exatamente uma vez. Devolve uma instância de GcpObservability que tem de guardar para chamar close() mais tarde.

GcpObservability.close() anula a atribuição de recursos. Os canais ou os servidores criados posteriormente não registam nada.

GcpObservability implementa java.lang.AutoCloseable, que é fechado automaticamente se usar try-with-resources da seguinte forma:

...
import io.grpc.gcp.observability.GcpObservability;
...

// Main application class
...

public static void main(String[] args) {
...
   // call GcpObservability.grpcInit() to initialize & get observability
   try (GcpObservability observability = GcpObservability.grpcInit()) {

...
   } // observability.close() called implicitly
...
}

Use a ferramenta de compilação do Gradle

Se estiver a usar a ferramenta de compilação Gradle, inclua o seguinte:

def grpcVersion = '1.54.1'

...

dependencies {
...
   implementation "io.grpc:grpc-gcp-observability:${grpcVersion}"
...
}

Use a ferramenta de compilação Maven (pom.xml)

Se estiver a usar a ferramenta de compilação Maven, inclua o seguinte:

<properties>
...
  <grpc.version>1.54.1</grpc.version>
...
</properties>

...

<dependencies>
...
 <dependency>
   <groupId>io.grpc</groupId>
   <artifactId>grpc-gcp-observability</artifactId>
   <version>${grpc.version}</version>
 </dependency>
...
</dependencies>

Ative a recolha de dados de métricas, rastreio e registo

As secções seguintes contêm instruções para ativar a recolha de dados na sua configuração e um exemplo que mostra as informações de configuração numa variável de ambiente.

Ative as métricas

Para ativar as métricas, adicione o objeto cloud_monitoring à configuração e defina o respetivo valor como {}.

Para mais informações sobre métricas, consulte o artigo Definições de métricas.

Ative o rastreio

Se planeia ativar o rastreio entre serviços, certifique-se de que os serviços suportam a propagação do contexto de rastreio recebido a montante (ou iniciado por si próprios) para a jusante.

Para ativar o rastreio, faça o seguinte:

  1. Adicione o objeto cloud_trace à configuração.
  2. Defina o cloud_trace.sampling_rate para uma probabilidade que quer que a sua aplicação observe para iniciar novos rastreios.
    • Por exemplo, 1.0 significa rastrear todos os RPCs.
    • 0.0 significa não iniciar novos rastreios.
    • 0.5 significa que 50% dos RPCs são rastreados aleatoriamente.

Se for tomada uma decisão de amostragem positiva a montante, os seus serviços carregam intervalos, independentemente da definição da taxa de amostragem.

Para mais informações sobre o rastreio, consulte o artigo Definições de rastreio.

Ative o registo

Para ativar o registo, faça o seguinte:

  1. Adicione o objeto cloud_logging à configuração.
  2. Adicione um padrão a client_rpc_events ou server_rpc_events, ou a ambos, especificando o conjunto de serviços ou métodos para os quais quer gerar o registo de eventos ao nível do transporte e o número de bytes a registar para cabeçalhos e mensagens.

Para mais informações sobre o registo, consulte o artigo Definições de registos.

Exemplo de variável de ambiente

O exemplo seguinte define as variáveis de observabilidade na variável de ambiente GRPC_GCP_OBSERVABILITY_CONFIG:

export GRPC_GCP_OBSERVABILITY_CONFIG='{
     "project_id": "your-project-here",
     "cloud_logging": {
         "client_rpc_events": [
         {
             "methods": ["google.pubsub.v1.Subscriber/Acknowledge", "google.pubsub.v1.Publisher/CreateTopic"],
             "exclude": true
         },
         {
             "methods": ["google.pubsub.v1.Subscriber/*", "google.pubsub.v1.Publisher/*"],
             "max_metadata_bytes": 4096,
             "max_message_bytes": 4096
         }],
         "server_rpc_events": [{
             "methods": ["*"],
             "max_metadata_bytes": 4096,
             "max_message_bytes": 4096
         }],
     },
     "cloud_monitoring": {},
     "cloud_trace": {
         "sampling_rate": 1.00
     },
     "labels": {
         "SOURCE_VERSION": "J2e1Cf",
         "SERVICE_NAME": "payment-service-1Cf",
         "DATA_CENTER": "us-west1-a"
     }
}'

Crie o exemplo de observabilidade

Use estas instruções para criar e estabelecer ligação a uma instância de VM do Compute Engine e, em seguida, configurar o exemplo de observabilidade.

  1. Crie uma instância de VM:

    gcloud compute instances create grpc-observability-vm \
  --image-family=debian-11 \
  --image-project=debian-cloud \
  --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

  2. Estabeleça ligação à instância de VM:

    gcloud compute ssh --project=PROJECT_ID grpc-observability-vm

Continue com as instruções para Java, C++ ou Go, consoante o idioma das suas aplicações gRPC.

Java

  1. Depois de estabelecer ligação à instância de VM, certifique-se de que tem o Java 8 ou posterior instalado.

    sudo apt update
sudo apt upgrade
sudo apt install git
sudo apt-get install -y openjdk-11-jdk-headless

  2. Clone o repositório grpc-java.

    export EXAMPLES_VERSION=v1.54.1
git clone -b $EXAMPLES_VERSION --single-branch --depth=1 \
https://github.com/grpc/grpc-java.git

  3. Aceda ao diretório de exemplos.

    cd grpc-java/examples/example-gcp-observability

  4. No diretório de exemplos, abra o ficheiro README e siga as instruções no ficheiro.

  5. Quando as instruções lhe indicarem que abra outra janela de terminal, emita o seguinte comando:

    gcloud compute ssh --project=PROJECT_ID grpc-observability-vm

C++

  1. Depois de estabelecer ligação à instância de VM, execute um ficheiro binário do servidor hello-world numa janela de terminal.

    sudo apt-get update -y
sudo apt-get install -y git build-essential clang
git clone -b v1.54.0 https://github.com/grpc/grpc.git --depth=1
cd grpc
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
export GRPC_GCP_OBSERVABILITY_CONFIG_FILE="$(pwd)/examples/cpp/gcp_observability/helloworld/server_config.json"
tools/bazel run examples/cpp/gcp_observability/helloworld:greeter_server

  2. Noutra janela do terminal, ligue-se novamente à VM através do SSH e, em seguida, execute os seguintes comandos, que executam o binário do cliente hello-world.

    cd grpc
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
export GRPC_GCP_OBSERVABILITY_CONFIG_FILE="$(pwd)/examples/cpp/gcp_observability/helloworld/client_config.json"
tools/bazel run examples/cpp/gcp_observability/helloworld:greeter_client

Ir

  1. Certifique-se de que tem o Go instalado.

    sudo apt-get install -y git
sudo apt install wget
wget https://go.dev/dl/go1.20.2.linux-amd64.tar.gz
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf \
go1.20.2.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

  2. Clone os exemplos gRPC-Go.

    git clone https://github.com/grpc/grpc-go.git
cd grpc-go/
git checkout -b run-observability-example
875c97a94dca8093bf01ff2fef490fbdd576373d

  3. Aceda ao clone do diretório gRPC-Go:

    cd examples/features/observability

  4. Execute o servidor.

    export GRPC_GCP_OBSERVABILITY_CONFIG_FILE=./server/serverConfig.json
go run ./server/main.go

  5. Numa janela de terminal separada, execute os seguintes comandos.

    export PATH=$PATH:/usr/local/go/bin
cd grpc-go/examples/features/observability
export GRPC_GCP_OBSERVABILITY_CONFIG_FILE=./client/clientConfig.json
go run ./client/main.go

Veja rastreios, métricas e entradas do registo

Use as instruções nesta secção para ver rastreios, métricas e entradas de registo.

Veja rastreios no Cloud Trace

Depois de configurar os exemplos ou instrumentar as cargas de trabalho, deve ver rastreios gerados pelos clientes gRPC e servidores gRPC naGoogle Cloud consola apresentados como rastreios recentes.

Lista de rastreios de observabilidade de microserviços.
Lista de rastreios de observabilidade de microsserviços (clique para aumentar)

Veja registos de rastreios

Se ativar o registo e o rastreio, pode ver as entradas de registo para rastreios juntamente com o gráfico de cascata do Cloud Trace ou no Explorador de registos.

Veja as métricas no painel de controlo

A observabilidade dos microsserviços oferece um painel de controlo de monitorização denominado Monitorização de microsserviços (gRPC) para as métricas definidas em Definições de métricas. O painel de controlo é apresentado na consola apenas quando a API Microservices está ativada. Google Cloud A Google Cloud consola chama a API Service Usage para verificar se a API Microservices está ativada num projeto. O utilizador tem de ter a autorização serviceusage.services.list para ver o painel de controlo.

O painel de controlo Monitorização de microsserviços (gRPC) é um Google Cloud painel de controlo e não o pode modificar diretamente. Para personalizar o painel de controlo, tem de copiar o painel de controlo para um painel de controlo personalizado. Em seguida, pode atualizar o painel de controlo personalizado, por exemplo, adicionando, eliminando ou reorganizando os gráficos.

Veja métricas no Explorador de métricas

Depois de configurar o exemplo de gRPC ou instrumentar a sua carga de trabalho, deve ver as métricas geradas pelos seus clientes gRPC e servidores gRPC naGoogle Cloud consola.

Para ver e representar métricas em gráficos, siga as instruções em Selecione métricas quando usar o explorador de métricas

Inspecione entradas de registo no Explorador de registos

A consulta sugerida é uma funcionalidade do Cloud Logging que Google Cloud sugere um conjunto de consultas com base nos registos carregados. Pode clicar e usar os filtros preparados.

Consultas sugeridas no Explorador de registos.
Consultas sugeridas no Explorador de registos. (clique para aumentar)

Depois de as entradas do registo correspondentes às consultas sugeridas aparecerem no Cloud Logging, pode esperar ver novas consultas sugeridas em aproximadamente 6 minutos. Na maioria dos casos, vê novas consultas sugeridas mais cedo. Se existirem entradas de registo que correspondam a uma sugestão nos 15 minutos anteriores, as consultas sugeridas continuam a ser apresentadas. Continuam a aparecer como sugestão até não existirem entradas de registo correspondentes nos 15 minutos anteriores.

Pode criar consultas personalizadas. Consulte o guia da linguagem de consulta de registo para obter instruções. Por exemplo, no painel de consulta do Explorador de registos, pode tentar mostrar todos os registos de depuração gRPC com o seguinte código:

log_id("microservices.googleapis.com/observability/grpc")

Pode usar todos os campos no registo do gRPC para filtragem. Segue-se um exemplo de uma entrada do registo:

{
  "insertId": "17kh8vafzuruci",
  "jsonPayload": {
    "authority": "10.84.1.15:50051",
    "sequenceId": "6",
    "serviceName": "helloworld.Greeter",
    "peer": {
      "ipPort": 50051,
      "address": "10.84.1.10",
      "type": "IPV4"
    },
    "callId": "d9577780-c608-4bff-9e12-4d9cdea6b298",
    "type": "SERVER_TRAILER",
    "methodName": "SayHello",
    "payload": {},
    "logger": "CLIENT"
  },
  "resource": {
    "type": "k8s_container",
    "labels": {
      "pod_name": "grpc-client-deployment-155-6967959544-x8ndr",
      "container_name": "grpc-client-container-155",
      "cluster_name": "o11y-cluster",
      "namespace_name": "grpc-client-namespace-155",
      "location": "us-west1-b",
      "project_id": "grpc-greeter"
    }
  },
  "timestamp": "2023-04-05T23:33:41.718523Z",
  "severity": "DEBUG",
  "labels": {
    "environment": "example-client"
  },
  "logName": "projects/grpc-greeter/logs/microservices.googleapis.com%2Fobservability%2Fgrpc",
  "receiveTimestamp": "2023-04-05T23:33:42.712682457Z"
}

Consultas sugeridas

A observabilidade dos microsserviços fornece as seguintes consultas sugeridas ao Cloud Logging:

Registos de cabeçalhos ou trailers para gRPCs

Esta consulta oferece uma vista básica dos RPCs, gerando informações de pares e resultados dos RPCs.

log_id("microservices.googleapis.com/observability/grpc") AND
jsonPayload.type=("CLIENT_HEADER" OR "SERVER_TRAILER")

Chamadas gRPC com falhas

Esta consulta encontra os RPCs que terminam com um estado diferente de OK.

log_id("microservices.googleapis.com/observability/grpc") AND
jsonPayload.type="SERVER_TRAILER" AND
jsonPayload.payload.statusCode!="OK"

Registos de registo para gRPCs cancelados ou com prazo excedido

O cancelamento excessivo de gRPC ou o exceder do prazo podem fornecer informações úteis sobre a perda de desempenho ou o comportamento inesperado da aplicação.

log_id("microservices.googleapis.com/observability/grpc") AND
((jsonPayload.type="SERVER_TRAILER" AND jsonPayload.payload.statusCode=("CANCELLED" OR "DEADLINE_EXCEEDED")) OR (jsonPayload.type="CANCEL"))

Use registos e rastreio para a resolução de problemas

Se vir um evento RPC que indique um comportamento incorreto, pode encontrar o callid no evento. Use a seguinte consulta para apresentar todos os eventos que ocorreram num RPC, independentemente de ser um RPC unário ou de streaming. A entrada de registo anterior é usada como exemplo:

log_id("microservices.googleapis.com/observability/grpc")
jsonPayload.callid="a358c7b80-3548-4bc8-a33f-b93ba1514904"

Para determinar o âmbito do problema, pode encontrar todos os eventos RPC para o mesmo método ou localização. A consulta seguinte mostra todos os registos de depuração relacionados com um método RPC específico, usando o serviço Greeter como exemplo:

log_id("microservices.googleapis.com/observability/grpc")
jsonPayload.serviceName="helloworld.Greeter"
jsonPayload.methodName="SayHello"

Para verificar os RPCs com falhas de um código de estado específico, pode adicionar o código de estado como uma das condições de filtragem. A seguinte consulta mostra os eventos de trailer que terminam com um estado diferente de OK:

log_id("microservices.googleapis.com/observability/grpc")
jsonPayload.payload.statusCode!="OK"
Resultados da consulta: código de estado de prazo excedido.
Resultados da consulta: código de estado de prazo excedido (clique para aumentar)

Opções de observabilidade

A observabilidade dos microsserviços inclui as seguintes funcionalidades opcionais.

Defina etiquetas personalizadas

Pode definir etiquetas personalizadas, que adicionam informações fornecidas pelos utilizadores aos dados de observabilidade. As etiquetas personalizadas consistem em pares de chave-valor. Cada par chave-valor é anexado aos dados de rastreio como etiquetas de intervalo, aos dados de métricas como etiquetas de métricas e aos dados de registo como etiquetas de entrada de registo.

As etiquetas personalizadas são definidas na configuração com uma lista de pares de chave-valor no campo labels. Todas as chaves e valores de etiquetas personalizadas são do tipo STRING. A implementação lê a configuração e cria uma etiqueta separada para cada par chave-valor. Em seguida, anexa as etiquetas aos dados de observabilidade.

Por exemplo, esta é uma definição de etiqueta:

"labels": {
    "DATACENTER": "SAN_JOSE_DC",
    "APP_ID": "24512"
  }

Cada entrada de registo tem as seguintes etiquetas adicionais:

{
   "DATACENTER" : "SAN_JOSE_DC"
   "APP_ID" : "24512"
}
Consultar etiquetas numa entrada de registo.
Consultar etiquetas numa entrada de registo (clique para aumentar)
Gráfico de linhas a mostrar etiquetas personalizadas e de recursos.
Gráfico de linhas que mostra etiquetas personalizadas e de recursos (clique para aumentar)

Ative o registo de payloads

Ativa o registo de payload através das variáveis de ambiente que fornece à carga de trabalho. Para ativar o registo de payloads para mensagens e cabeçalhos HelloWorld, atualize o valor dos ficheiros de configuração gcp_observability_server_config.json, gcp_observability_client_config.json ou ambos nos exemplos de gRPC da seguinte forma:

{
   "cloud_monitoring":{
   },
   "cloud_trace":{
      "sampling_rate":1.0
   },
   "cloud_logging":{
      "client_rpc_events":[
         {
            "methods":[
               "helloworld.Greeter/*"
            ],
            "max_metadata_bytes":4096,
            "max_message_bytes":4096
         }
      ],
      "server_rpc_events":[
         {
            "methods":[
               "helloworld.Greeter/*"
            ],
            "max_metadata_bytes":4096,
            "max_message_bytes":4096
         }
      ]
   }
}

Configure a observabilidade entre projetos

Pode definir o projeto de destino explicitamente através da configuração definida na variável de ambiente GRPC_GCP_OBSERVABILITY_CONFIG. Para a observabilidade entre projetos, também tem de definir as autorizações da conta de serviço adequadas. Partindo do princípio de que o ID do projeto de destino é core-platform-stats, pode configurar a observabilidade entre projetos com a seguinte configuração de exemplo:

{
   "project_id":"core-platform-stats",
   "cloud_monitoring":{
   },
   "cloud_trace":{
      "sampling_rate":1.0
   },
   "cloud_logging":{
      "client_rpc_events":[
         {
            "methods":[
               "helloworld.Greeter/*"
            ]
         }
      ],
      "server_rpc_events":[
         {
            "methods":[
               "helloworld.Greeter/*"
            ]
         }
      ]
   }
}

Estime o volume de registos

Esta secção fornece informações que pode usar para estimar opcionalmente o volume de carregamento de registos. Pode fazer uma estimativa antes de subscrever os eventos RPC dos seus serviços.

Item Detalhe
Eventos gerados para uma chamada unária OK 6 eventos

Uma RPC de chamada unária OK gera os seguintes 6 eventos para o cliente ou o servidor:

  • CLIENT_HEADER
  • SERVER_HEADER
  • CLIENT_MESSAGE
  • SERVER_MESSAGE
  • CLIENT_HALF_CLOSE
  • SERVER_TRAILER
Tamanho médio da entrada do registo 500 bytes por predefinição

Uma entrada de registo é mapeada para um evento RPC. O evento RPC inclui as informações de depuração detalhadas desse evento, etiquetas de recursos e etiquetas personalizadas.
Tamanho do registo de payloads 0 por predefinição, pode ser configurado

O tamanho máximo da carga útil é configurável na configuração de observabilidade. Por predefinição, não é registado nenhum payload.
Tamanho das etiquetas personalizadas 0 por predefinição, pode ser configurado

As etiquetas personalizadas são fornecidas à aplicação através de variáveis de ambiente. Se não for especificada nenhuma, não existem etiquetas personalizadas

Fórmula de estimativa do tamanho total do carregamento de registos por mês:

Monthly Log Ingestion = QPS * 6 * (500B + Payload Logging Size + Custom Labels Size) * 2592000

Por exemplo, se o CPS de um método de chamada unário for 1 e não estiverem ativadas funcionalidades adicionais, o tamanho de carregamento de registos estimado é de aproximadamente 7,24 GiB.

O que se segue?