Para informações sobre a versão, consulte as notas da versão do Distributed Cloud Connected.

Registros e métricas

Nesta página, explicamos como o Google Distributed Cloud registra vários tipos de informações sobre a operação dele e como visualizar essas informações. A coleta de alguns tipos de registros e métricas gera cobranças adicionais. Para mais informações, consulte Faturamento de registros e métricas.

Configurar a geração de registros e o monitoramento

Antes de começar a coletar registros e métricas, faça o seguinte:

Ative as APIs de geração de registros usando os seguintes comandos:

gcloud services enable opsconfigmonitoring.googleapis.com --project PROJECT_ID
gcloud services enable logging.googleapis.com --project PROJECT_ID
gcloud services enable monitoring.googleapis.com --project PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto Google Cloud de destino.

Conceda os papéis necessários para gravar registros e métricas:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --role roles/opsconfigmonitoring.resourceMetadata.writer \
    --member "serviceAccount:PROJECT_ID.svc.id.goog[kube-system/metadata-agent]"

gcloud projects add-iam-policy-binding PROJECT_ID \
    --role roles/logging.logWriter \
     --member "serviceAccount:PROJECT_ID.svc.id.goog[kube-system/stackdriver-log-forwarder]"

gcloud projects add-iam-policy-binding PROJECT_ID \
    --role roles/monitoring.metricWriter \
    --member "serviceAccount:PROJECT_ID.svc.id.goog[kube-system/gke-metrics-agent]"

Substitua PROJECT_ID pelo ID do projeto Google Cloud de destino.

Registros

Esta seção lista os tipos de recursos do Cloud Logging compatíveis com o Distributed Cloud. Para ver os registros do Distributed Cloud, use o Explorador de registros no console Google Cloud . O registro em log do Distributed Cloud está sempre ativado.

Os tipos de recursos registrados do Distributed Cloud são os seguintes recursos padrão do Kubernetes:

k8s_container
k8s_node

Também é possível capturar e recuperar registros do Distributed Cloud usando a API Cloud Logging. Para informações sobre como configurar esse mecanismo de registro em log, consulte a documentação das bibliotecas de cliente do Cloud Logging.

Métricas

Esta seção lista as métricas do Cloud Monitoring compatíveis com o Distributed Cloud. Para conferir as métricas do Distributed Cloud, use o Metrics Explorer no console doGoogle Cloud .

Métricas do cluster do Distributed Cloud

Para clusters do Distributed Cloud, o Distributed Cloud fornece os seguintes tipos de métricas geradas pelos nós do Distributed Cloud:

As métricas de recursos fornecem informações sobre o desempenho do nó e do pod do Distributed Cloud, como carga da CPU e uso de memória.
As métricas de aplicativos do sistema fornecem informações sobre cargas de trabalho do sistema do Distributed Cloud, como coredns.

Para uma lista dessas métricas, consulte Métricas do Google Distributed Cloud e do Google Distributed Cloud.

O Distributed Cloud não fornece métricas geradas pelos planos de controle do Kubernetes associados aos clusters do Distributed Cloud.

Métricas de hardware do Distributed Cloud

O Distributed Cloud fornece métricas para hardware do Distributed Cloud usando os seguintes tipos de recursos:

edgecontainer.googleapis.com/Machine
edgecontainer.googleapis.com/Rack

Métricas de recursos `Machine`

O Distributed Cloud grava as seguintes métricas da API Cloud Monitoring para o recurso edgecontainer.googleapis.com/Machine:

Métrica	Descrição
`/machine/cpu/total_cores` Tipo: `GAUGE` Tipo: `INT`	Contagem total de núcleos de processador físicos presentes na máquina.
`/machine/cpu/usage_time` Tipo: `CUMULATIVE` Tipo: `DOUBLE` Unidade: `Seconds`	Tempo de uso cumulativo da CPU para todos os núcleos na máquina. O tipo pode ser `workload` (cargas de trabalho do cliente) ou `system` (todo o resto).
`/machine/cpu/utilization` Tipo: `GAUGE` Tipo: `DOUBLE`	Porcentagem de utilização da CPU na máquina. O intervalo é de 0 a 1. O tipo pode ser `workload` (cargas de trabalho do cliente) ou `system` (todo o resto).
`/machine/memory/total_bytes` Tipo: `GAUGE` Tipo: `INT64`	Contagem de bytes da memória total na máquina.
`/machine/memory/used_bytes` Tipo: `GAUGE` Tipo: `INT64`	Contagem de bytes da memória usada na máquina. `memory_type` é `evictable` (recuperável pelo kernel) ou `non-evictable` (não recuperável).
`/machine/memory/utilization` Tipo: `GAUGE` Tipo: `DOUBLE`	Porcentagem de uso da memória na máquina. O intervalo é de 0 a 1. `memory_type` é `evictable` (recuperável pelo kernel) ou `non-evictable` (não recuperável).
`/machine/network/up` Tipo: `GAUGE` Tipo: `BOOL`	Indica se a interface de rede está funcionando. Inclui cartões principais, secundários e portas.
`/machine/network/link_speed` Tipo: `GAUGE` Tipo: `DOUBLE` Unidade: bytes por segundo	Velocidade do link da placa de interface de rede principal.
`/machine/network/received_bytes_count` Tipo: `CUMULATIVE` Tipo: `DOUBLE`	Contagem de bytes recebidos para a placa de interface de rede principal.
`/machine/network/sent_bytes_count` Tipo: `CUMULATIVE` Tipo: `DOUBLE`	Contagem de bytes enviados para a placa de interface de rede principal.
`/machine/network/connectivity` Tipo: `GAUGE` Tipo: `BOOL`	Indica se a placa de rede principal tem conectividade com a Internet.
`/machine/disk/total_bytes` Tipo: `GAUGE` Tipo: `INT64`	Contagem de bytes do espaço total em disco na máquina.
`/machine/disk/used_bytes` Tipo: `GAUGE` Tipo: `INT64`	Contagem de bytes do espaço em disco usado na máquina.
`/machine/disk/utilization` Tipo: `GAUGE` Tipo: `DOUBLE`	Porcentagem de utilização do espaço em disco na máquina. O intervalo é de 0 a 1.
`/machine/restart_count` Tipo: `CUMULATIVE` Tipo: `INT`	Número de reinicializações que a máquina passou.
`/machine/uptime` Tipo: `GAUGE` Tipo: `INT` Unidade: `Seconds`	Tempo de atividade da máquina desde a última reinicialização.
`/machine/connected` Tipo: `GAUGE` Tipo: `INT64`	Indica se a máquina está conectada a Google Cloud.

Métricas de recursos `Rack`

O Distributed Cloud grava as seguintes métricas da API Cloud Monitoring para o recurso edgecontainer.googleapis.com/Rack:

Métrica	Descrição
`/router/bgp_up` Tipo: `GAUGE` Tipo: `BOOL`	Indica se a sessão de peering do BGP no roteador está ativa e íntegra. `router_id` identifica o roteador específico (até dois por rack).
`/router/connected` Tipo: `GAUGE` Tipo: `BOOL`	Indica se o roteador BGP está conectado a Google Cloud. `router_id` identifica o roteador específico (até dois por rack).

Exportar registros e métricas de aplicativos personalizados

A nuvem distribuída exporta automaticamente os registros de aplicativos em execução nas cargas de trabalho da nuvem distribuída. Para exportar métricas de um aplicativo em execução em cargas de trabalho do Distributed Cloud, é preciso fazer anotações nele, conforme descrito na próxima seção.

Anotar a carga de trabalho para ativar a exportação de métricas

Para ativar a coleta de métricas personalizadas de um aplicativo, adicione as seguintes anotações ao manifesto de serviço ou de implantação do aplicativo:

prometheus.io/scrape: "true"
prometheus.io/path: "ENDPOINT_PATH". Substitua ENDPOINT_PATH pelo caminho completo para o endpoint de métricas do aplicativo de destino.
prometheus.io/port: "PORT_NUMBER": a porta em que o endpoint de métricas do aplicativo escuta conexões.

Executar um aplicativo de exemplo

Nesta seção, você vai criar um aplicativo que grava registros personalizados e expõe um endpoint de métrica personalizada.

Salve os seguintes manifestos de Serviço e Implantação em um arquivo chamado my-app.yaml. Observe que o Serviço tem a anotação prometheus.io/scrape: "true":

kind: Service
apiVersion: v1
metadata:
  name: "monitoring-example"
  namespace: "default"
  annotations:
    prometheus.io/scrape: "true"
spec:
  selector:
    app: "monitoring-example"
  ports:
    - name: http
      port: 9090
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: "monitoring-example"
  namespace: "default"
  labels:
    app: "monitoring-example"
spec:
  replicas: 1
  selector:
    matchLabels:
      app: "monitoring-example"
  template:
    metadata:
      labels:
        app: "monitoring-example"
    spec:
      containers:
      - image: gcr.io/google-samples/prometheus-dummy-exporter:latest
        name: prometheus-example-exporter
        imagePullPolicy: Always
        command:
        - /bin/sh
        - -c
        - ./prometheus-dummy-exporter --metric-name=example_monitoring_up --metric-value=1 --port=9090
        resources:
          requests:
            cpu: 100m

Crie a implantação e o serviço:

kubectl --kubeconfig apply -f my-app.yaml

Veja os registros do aplicativo.

Console

No console do Google Cloud , acesse a página Análise de registros.
Acessar a Análise de registros
Clique em Recurso.
Na lista Todos os tipos de recursos, selecione Kubernetes Container.
Em Nome do cluster, selecione o nome do cluster de usuário.
Em Nome do namespace, selecione default.
Clique em Adicionar e em Executar consulta.

Na seção Resultados da consulta, é possível ver as entradas de registro da implantação monitoring-example. Exemplo:

{
  "textPayload": "2020/11/14 01:24:24 Starting to listen on :9090\n",
  "insertId": "1oa4vhg3qfxidt",
  "resource": {
    "type": "k8s_container",
    "labels": {
      "pod_name": "monitoring-example-7685d96496-xqfsf",
      "cluster_name": ...,
      "namespace_name": "default",
      "project_id": ...,
      "location": "us-west1",
      "container_name": "prometheus-example-exporter"
    }
  },
  "timestamp": "2020-11-14T01:24:24.358600252Z",
  "labels": {
    "k8s-pod/pod-template-hash": "7685d96496",
    "k8s-pod/app": "monitoring-example"
  },
  "logName": "projects/.../logs/stdout",
  "receiveTimestamp": "2020-11-14T01:24:39.562864735Z"
}

gcloud

Use o comando gcloud logging read:

gcloud logging read 'resource.labels.project_id="PROJECT_ID" AND \
    resource.type="k8s_container" AND resource.labels.namespace_name="default"'

Substitua PROJECT_ID pelo ID do seu projeto.

Na saída, é possível ver entradas de registro da implantação monitoring-example. Exemplo:

insertId: 1oa4vhg3qfxidt
labels:
  k8s-pod/app: monitoring-example
  k8s- pod/pod-template-hash: 7685d96496
logName: projects/.../logs/stdout
receiveTimestamp: '2020-11-14T01:24:39.562864735Z'
resource:
  labels:
    cluster_name: ...
    container_name: prometheus-example-exporter
    location: us-west1
    namespace_name: default
    pod_name: monitoring-example-7685d96496-xqfsf
    project_id: ...
  type: k8s_container
textPayload: |
  2020/11/14 01:24:24 Starting to listen on :9090
timestamp: '2020-11-14T01:24:24.358600252Z'

Ver métricas do aplicativo

O aplicativo de exemplo expõe uma métrica personalizada chamada example_monitoring_up. É possível ver os valores dessa métrica no console do Google Cloud .

No console do Google Cloud , acesse a página do Metrics explorer.
Acesse o Metrics explorer
Em Tipo de recurso, selecione Kubernetes Pod.
Em Métrica, selecione external/prometheus/example_monitoring_up.
No gráfico, você pode ver que example_monitoring_up tem um valor repetido de 1.

A seguir

Registro de auditoria

Registros e métricas Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.