Monitorize instâncias com o Cloud Monitoring

Este documento descreve como usar a consola do Cloud Monitoring para monitorizar as suas instâncias do Spanner.

A consola do Cloud Monitoring oferece várias ferramentas de monitorização para o Spanner:

• Um painel de controlo organizado que mostra gráficos pré-criados para os seus recursos do Spanner
• Gráficos personalizados, incluindo gráficos ad hoc no explorador de métricas, bem como gráficos em painéis de controlo personalizados
• Alertas, que lhe enviam uma notificação se uma métrica exceder um limite especificado por si

Se preferir monitorizar o Spanner por programação, use as bibliotecas de cliente do Google Cloud para o Cloud Monitoring para obter métricas.

Nota: também pode monitorizar as suas instâncias vendo gráficos na Google Cloud consola. Use a Google Cloud consola para ter uma vista rápida das métricas mais importantes para a sua instância.

Use o painel de controlo organizado do Cloud Monitoring

O Cloud Monitoring oferece-lhe um painel de controlo organizado que resume as principais informações sobre as suas instâncias do Spanner, incluindo:

• Incidentes: alertas de monitorização criados pelo utilizador que estão abertos, ativos ou resolvidos
• Eventos: uma lista de registos de auditoria do Spanner (se ativados e disponíveis)
• Instâncias: um resumo de alto nível das suas instâncias do Spanner, incluindo a capacidade de computação, a quantidade de bases de dados e o estado da instância
• Gráficos agregados da taxa de transferência e da utilização do armazenamento

Para ver o painel de controlo do Spanner, faça o seguinte:

1. Na Google Cloud consola, selecione Monitorização ou use o botão seguinte:

   Aceder a Monitorização

2. Se Recursos for apresentado no painel de navegação, selecione Recursos e, de seguida, selecione Cloud Spanner. Caso contrário, selecione Painéis de controlo e, de seguida, selecione o painel de controlo com o nome Cloud Spanner.

Veja os detalhes da instância e da base de dados

Quando abre o painel de controlo organizado para o Spanner, este mostra dados agregados para todas as suas instâncias. Pode ver mais detalhes sobre uma instância específica clicando no nome da instância em Instâncias.

O painel de controlo apresenta informações como metadados de instâncias, bases de dados na instância e gráficos de várias métricas discriminadas por região.

Na página do painel de controlo da instância, também pode ver gráficos de uma base de dados específica na instância:

1. No lado direito, acima dos gráficos de métricas de instâncias, clique em Métricas da base de dados.

2. Na lista pendente Selecionar uma discriminação, selecione a base de dados que quer examinar.

   A consola do Cloud Monitoring apresenta gráficos para a base de dados.

Crie gráficos personalizados para métricas do Spanner

Pode usar o Cloud Monitoring para criar gráficos personalizados para métricas do Spanner. Pode usar o explorador de métricas para criar gráficos temporários e ad hoc ou pode criar gráficos que aparecem em painéis de controlo personalizados.

Em particular, o Cloud Monitoring permite-lhe criar um gráfico personalizado que mostra se duas ou mais métricas estão correlacionadas entre si. Por exemplo, pode verificar se existe uma correlação entre a utilização da CPU e a latência numa instância do Spanner, o que pode indicar que a sua instância precisa de mais capacidade de computação ou que algumas das suas consultas estão a causar uma utilização elevada da CPU.

Para começar a usar este exemplo, siga estes passos:

1. Na Google Cloud consola, selecione Monitorização ou use o botão seguinte:

   Aceder a Monitorização

2. Se o Explorador de métricas for apresentado no painel de navegação, selecione-o. Caso contrário, selecione Recursos e, de seguida, Explorador de métricas.

3. Clique no separador Opções de visualização e, de seguida, selecione a caixa de verificação Escala logarítmica no eixo Y. Esta opção ajuda a comparar várias métricas quando uma métrica tem valores muito superiores aos das outras.

4. Na lista pendente acima do painel direito, selecione Linha.

5. Clique no separador Métricas. Agora, pode adicionar métricas ao gráfico.

Para adicionar métricas de latência ao gráfico, siga estes passos:

1. Na caixa Encontre o tipo de recurso e a métrica, introduza o valor spanner.googleapis.com/api/request_latencies e, de seguida, clique na linha apresentada abaixo da caixa.
2. Na caixa Filtro, introduza o valor instance_id, introduza o ID da instância que quer examinar e clique em Aplicar.
3. Na lista pendente Agregador, clique em máx..

4. Opcional: altere o percentil de latência:

   1. Clique em Mostrar opções avançadas.

   2. Clique na lista pendente Alinhador e, de seguida, clique no percentil de latência que quer ver.

      Na maioria dos casos, deve analisar a latência do 50.º percentil para compreender a quantidade típica de latência ou a latência do 99.º percentil para compreender a latência do 1% mais lento de pedidos.

Para adicionar métricas de utilização da CPU ao gráfico, siga estes passos:

1. Clique em Adicionar métrica.
2. Na caixa Encontre o tipo de recurso e a métrica, introduza o valor spanner.googleapis.com/instance/cpu/utilization e, de seguida, clique na linha que aparece abaixo da caixa.
3. Na caixa Filtro, introduza o valor instance_id, introduza o ID da instância que quer examinar e clique em Aplicar.
4. Na lista pendente Agregador, clique em máx..

Agora, tem um gráfico que mostra as métricas de utilização da CPU e latência para uma instância do Spanner. Se ambas as métricas forem superiores ao esperado ao mesmo tempo, pode tomar medidas adicionais para corrigir o problema.

Para mais informações sobre a criação de gráficos personalizados, consulte a documentação do Cloud Monitoring.

Crie alertas para métricas do Spanner

Quando cria uma instância do Spanner, escolhe a capacidade de computação para a instância. À medida que a carga de trabalho da instância muda, o Spanner não ajusta automaticamente a capacidade de computação da instância. Como resultado, tem de configurar vários alertas para garantir que a instância permanece dentro dos máximos recomendados para a utilização da CPU e do limite recomendado para o armazenamento.

Os exemplos seguintes mostram como configurar políticas de alerta para algumas métricas do Spanner. Para ver uma lista completa das métricas disponíveis, consulte a lista de métricas do Spanner.

CPU de alta prioridade

Para criar uma política de alertas que seja acionada quando a utilização da CPU de prioridade elevada para o Spanner estiver acima de um limite recomendado, use as seguintes definições.

Passos para criar uma política de alertas.

Para criar uma política de alertas, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Alertas:

   Aceder a Alertas

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. Se não tiver criado os canais de notificação e quiser receber notificações, clique em Editar canais de notificação e adicione os seus canais de notificação. Regresse à página Alertas depois de adicionar os seus canais.
3. Na página Alertas, selecione Criar política.
4. Para selecionar o recurso, a métrica e os filtros, expanda o menu Selecionar uma métrica e, de seguida, use os valores na tabela Nova condição:
   1. Opcional: para limitar o menu a entradas relevantes, introduza o recurso ou o nome da métrica na barra de filtro.
   2. Selecione um Tipo de recurso. Por exemplo, selecione Instância de VM.
   3. Selecione uma categoria de métricas. Por exemplo, selecione instância.
   4. Selecione uma métrica. Por exemplo, selecione Utilização da CPU.
   5. Selecione Aplicar.
5. Clique em Seguinte e, de seguida, configure o acionador da política de alertas. Para preencher estes campos, use os valores na tabela Configurar acionador de alerta.
6. Clicar em Seguinte.

7. Opcional: para adicionar notificações à sua política de alertas, clique em Canais de notificação. Na caixa de diálogo, selecione um ou mais canais de notificação no menu e, de seguida, clique em OK.

   Para receber uma notificação quando os incidentes são abertos e fechados, selecione a opção Notificar no encerramento do incidente. Por predefinição, as notificações são enviadas apenas quando são abertos incidentes.

8. Opcional: atualize a Duração do encerramento automático do incidente. Este campo determina quando o Monitoring fecha incidentes na ausência de dados de métricas.
9. Opcional: clique em Documentação e, de seguida, adicione as informações que quer incluir numa mensagem de notificação.
10. Clique em Nome do alerta e introduza um nome para a política de alertas.
11. Clique em Criar política.

Nova condição Campo	Valor
Recurso e métrica	No menu Recursos, selecione Instância do Spanner. No menu Categorias de métricas, selecione Instância. No menu Métricas, selecione Utilização da CPU por prioridade. (O metric.type é spanner.googleapis.com/instance/cpu/utilization_by_priority).
Filtro	instance_id = YOUR_INSTANCE_ID priority = high
Em intervalos temporais Agrupamento de intervalos temporais	location para instâncias multirregionais; deixe em branco para instâncias regionais.
Em intervalos temporais Agregação de intervalos temporais	sum
Janela contínua	10 m
Função de período contínuo	mean

Configure o acionador de alerta Campo	Valor
Tipo de condição	Threshold
Acionador de alertas	Any time series violates
Posição do limite	Above threshold
Valor do limite	45% para instâncias multirregionais; 65% para instâncias regionais.
Período de novo teste	10 minutes

Média móvel de 24 horas da CPU

Para criar uma política de alertas que seja acionada quando a média móvel de 24 horas da utilização da CPU do Spanner estiver acima de um limite recomendado, use as seguintes definições.

Passos para criar uma política de alertas.

Para criar uma política de alertas, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Alertas:

   Aceder a Alertas

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. Se não tiver criado os canais de notificação e quiser receber notificações, clique em Editar canais de notificação e adicione os seus canais de notificação. Regresse à página Alertas depois de adicionar os seus canais.
3. Na página Alertas, selecione Criar política.
4. Para selecionar o recurso, a métrica e os filtros, expanda o menu Selecionar uma métrica e, de seguida, use os valores na tabela Nova condição:
   1. Opcional: para limitar o menu a entradas relevantes, introduza o recurso ou o nome da métrica na barra de filtro.
   2. Selecione um Tipo de recurso. Por exemplo, selecione Instância de VM.
   3. Selecione uma categoria de métricas. Por exemplo, selecione instância.
   4. Selecione uma métrica. Por exemplo, selecione Utilização da CPU.
   5. Selecione Aplicar.
5. Clique em Seguinte e, de seguida, configure o acionador da política de alertas. Para preencher estes campos, use os valores na tabela Configurar acionador de alerta.
6. Clicar em Seguinte.

7. Opcional: para adicionar notificações à sua política de alertas, clique em Canais de notificação. Na caixa de diálogo, selecione um ou mais canais de notificação no menu e, de seguida, clique em OK.

   Para receber uma notificação quando os incidentes são abertos e fechados, selecione a opção Notificar no encerramento do incidente. Por predefinição, as notificações são enviadas apenas quando são abertos incidentes.

8. Opcional: atualize a Duração do encerramento automático do incidente. Este campo determina quando o Monitoring fecha incidentes na ausência de dados de métricas.
9. Opcional: clique em Documentação e, de seguida, adicione as informações que quer incluir numa mensagem de notificação.
10. Clique em Nome do alerta e introduza um nome para a política de alertas.
11. Clique em Criar política.

Nova condição Campo	Valor
Recurso e métrica	No menu Recursos, selecione Instância do Spanner. No menu Categorias de métricas, selecione Instância. No menu Métricas, selecione Utilização da CPU suavizada. (O metric.type é spanner.googleapis.com/instance/cpu/smoothed_utilization).
Filtro	instance_id = YOUR_INSTANCE_ID
Em intervalos temporais Agregação de intervalos temporais	sum
Janela contínua	10 m
Função de período contínuo	mean

Configure o acionador de alerta Campo	Valor
Tipo de condição	Threshold
Acionador de alertas	Any time series violates
Posição do limite	Above threshold
Limite	90%
Período de novo teste	10 minutes

Armazenamento

Para criar uma política de alertas que é acionada quando o armazenamento da sua instância do Spanner está acima de um limite recomendado, use as seguintes definições.

Passos para criar uma política de alertas.

Para criar uma política de alertas, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Alertas:

   Aceder a Alertas

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. Se não tiver criado os canais de notificação e quiser receber notificações, clique em Editar canais de notificação e adicione os seus canais de notificação. Regresse à página Alertas depois de adicionar os seus canais.
3. Na página Alertas, selecione Criar política.
4. Para selecionar o recurso, a métrica e os filtros, expanda o menu Selecionar uma métrica e, de seguida, use os valores na tabela Nova condição:
   1. Opcional: para limitar o menu a entradas relevantes, introduza o recurso ou o nome da métrica na barra de filtro.
   2. Selecione um Tipo de recurso. Por exemplo, selecione Instância de VM.
   3. Selecione uma categoria de métricas. Por exemplo, selecione instância.
   4. Selecione uma métrica. Por exemplo, selecione Utilização da CPU.
   5. Selecione Aplicar.
5. Clique em Seguinte e, de seguida, configure o acionador da política de alertas. Para preencher estes campos, use os valores na tabela Configurar acionador de alerta.
6. Clicar em Seguinte.

7. Opcional: para adicionar notificações à sua política de alertas, clique em Canais de notificação. Na caixa de diálogo, selecione um ou mais canais de notificação no menu e, de seguida, clique em OK.

   Para receber uma notificação quando os incidentes são abertos e fechados, selecione a opção Notificar no encerramento do incidente. Por predefinição, as notificações são enviadas apenas quando são abertos incidentes.

8. Opcional: atualize a Duração do encerramento automático do incidente. Este campo determina quando o Monitoring fecha incidentes na ausência de dados de métricas.
9. Opcional: clique em Documentação e, de seguida, adicione as informações que quer incluir numa mensagem de notificação.
10. Clique em Nome do alerta e introduza um nome para a política de alertas.
11. Clique em Criar política.

Nova condição Campo	Valor
Recurso e métrica	No menu Recursos, selecione Instância do Spanner. No menu Categorias de métricas, selecione Instância. No menu Métricas, selecione Armazenamento usado. (O metric.type é spanner.googleapis.com/instance/storage/utilization).
Filtro	instance_id = YOUR_INSTANCE_ID
Em intervalos temporais Agregação de intervalos temporais	sum
Janela contínua	10 m
Função de período contínuo	max

Configure o acionador de alerta Campo	Valor
Tipo de condição	Threshold
O acionador de condição é acionado se	Any time series violates
Posição do limite	Above threshold
Valor do limite	Não tem de definir um limite específico para o armazenamento máximo por nó. No entanto, recomendamos que configure um alerta para quando se estiver a aproximar do limite máximo de armazenamento. Para saber mais, consulte o artigo Métricas de utilização do armazenamento.
Período de novo teste	10 minutes

Nota: os valores de utilização do Spanner são calculados em terabytes binários, em que 1 TB equivale a 2⁴⁰ bytes. Esta unidade de medida também é conhecida como tebibyte (TiB).

O que se segue?

• Compreenda as métricas de utilização da CPU e latência para o Spanner.
• Use a Google Cloud consola para ver rapidamente as métricas mais importantes para a sua instância.
• Saiba mais sobre o Cloud Monitoring.