Introdução à API Cloud Monitoring

Esta página descreve alguns dos recursos da API Cloud Monitoring v3.

Para a documentação de referência da API, consulte uma das seguintes páginas:

Recursos de API

Métrica

A API Monitoring v3 oferece acesso a mais de 1.500 métricas do Cloud Monitoring do Google Cloud e da Amazon Web Services. É possível criar suas próprias métricas personalizadas e organizar seus recursos de nuvem usando grupos.

Para uma introdução aos conceitos de métrica e às estruturas de dados que as representam, consulte Métricas, séries temporais e recursos.

Para saber como gerenciar suas métricas personalizadas e integradas, consulte Como usar métricas personalizadas.

Para ver uma lista completa de métricas disponíveis, consulte Lista de métricas.

Recursos monitorados

Um recurso monitorado abrange quais métricas são coletadas. Por exemplo, é possível ter interesse na atividade de uma instância de VM ou de um hardware.

Para ver uma lista dos recursos monitorados disponíveis, consulte a Lista de recursos monitorados.

Grupos de recursos monitorados

Um grupo é um conjunto dinâmico de recursos monitorados. Você sempre conseguiu criar grupos manualmente no console do Monitoring e também usou a API Cloud Monitoring para escrever código que cria e usa grupos.

Para saber mais, consulte a Referência da API sobre Group.

Políticas de alertas

Uma política de alertas é um recurso de configuração que descreve os critérios para gerar incidentes e como notificá-lo quando esses incidentes são criados. Os conceitos de alertas explicam os conceitos básicos das políticas de alertas. Para saber mais, consulte a Referência da API sobre AlertPolicy.

A API também permite criar políticas de alertas com base em uma proporção de duas métricas. No momento, não é possível criar proporções usando o Monitoring no Console do Google Cloud. Para mais informações, consulte MetricThreshold na referência de AlertPolicy.

Canais de notificação

Um canal de notificação é um recurso de configuração que descreve como notificar você quando ocorrerem incidentes. Os canais de notificação referem-se a vários tipos diferentes de serviços de comunicação e endpoints. Eles são especificados nos descritores. Os descritores determinam o conjunto de parâmetros de configuração incluídos em um objeto de canal.

Para mais informações, consulte a referência de NotificationChannel e a referência de NotificationChannelDescriptor.

Monitoramento do serviço

Os recursos de monitoramento de serviço são usados para configurar objetivos de nível de serviço que são usados para monitorar a integridade dos serviços.

O Service Monitoring inclui os recursos a seguir na API do Monitoring:

Para mais informações sobre esses conceitos de monitoramento de serviço e sobre como usar a API, consulte Monitoramento de SLO.

Painéis

É possível criar e manipular de maneira programática painéis e gráficos usando o endpoint Dashboards. Para informações sobre como usar esse endpoint para gerenciar painéis e gráficos, consulte Como gerenciar painéis por API.

Linguagem de consulta do Monitoring

A Linguagem de consulta do Monitoring (MQL) fornece uma interface baseada em texto para consultar dados de série temporal do Cloud Monitoring. A MQL usa um modelo de consulta em pipeline e é mais expressiva do que os filtros do Monitoring. É possível usar consultas MQL da API Monitoring ou do Editor de consultas.

Para informações gerais sobre MQL, consulte Como usar a Linguagem de consulta do Monitoring.

Para mais informações sobre como usar a MQL para recuperar dados de série temporal usando a API Monitoring, consulte a referência da API para o método timeSeries.query.

Para mais informações sobre como criar painéis com gráficos baseados em MQTT usando a API Monitoring, consulte a referência da API do objeto TimeSeriesQuery. Esse objeto fornece o mecanismo para recuperar o conjunto de dados de um gráfico ou de uma visão geral.

Conceitos da API

Filtros

A API Monitoring v3 usa filtros para selecionar métricas, buscar dados de série temporal e coletar recursos monitorados em grupos. Para mais informações, consulte Filtros de monitoramento.

A API Monitoring v3 também usa filtros para restringir o conjunto de resultados de determinadas operações list. Consulte Como classificar e filtrar para ver detalhes sobre como gerenciar os resultados dos métodos alertPolicies.list e notificationChannels.list.

A seguir