Métricas do Management Gateway

Você pode monitorar a integridade, a capacidade e o desempenho do seu gateway de gerenciamento usando métricas, alarmes e notificações.

Para obter mais informações, consulte Visão Geral do Serviço Monitoring e Visão Geral do Serviço Notifications.

Este tópico descreve as métricas emitidas pelo Management Gateway no namespace de métricas oci_managementgateway.

Visão Geral das Métricas do Management Gateway

As métricas do Management Gateway permitem que os administradores vejam o consumo de recursos do gateway de gerenciamento em termos de CPU, memória e disco.

Pré-requisitos

Políticas do serviço IAM: Para monitorar recursos, um usuário deve ter o tipo necessário de acesso em uma política gravada por um administrador. Isso se aplica se você estiver usando a Console ou a API REST com um SDK, uma CLI ou outra ferramenta. A política deve permitir acesso aos serviços de monitoramento e aos recursos que estão sendo monitorados. Se você tentar executar uma ação e receber uma mensagem informando que não tem permissão ou não está autorizado, confirme com o administrador o tipo de acesso concedido e em qual compartimento você deve trabalhar. Para obter mais informações sobre autorizações de usuário para monitoramento, consulte a seção Autenticação e Autorização do serviço relacionado: Monitoring ou Notifications. Para obter informações sobre políticas para gateway de gerenciamento, consulte Executar Pré-requisitos para a Implantação do Management Gateway.
As métricas listadas nesta página estão automaticamente disponíveis para qualquer Gateway que você instalar. Você não precisa ativar o monitoramento no recurso para obter essas métricas.

Métricas Disponíveis: oci_managementgateway

O Management Gateway emite métricas para o namespace de métricas oci_managementgateway no serviço Monitoring.

As métricas listadas nas tabelas a seguir estão automaticamente disponíveis para qualquer Gateway que você instalar. Você não precisa ativar o monitoramento para obter essas métricas. Você também pode usar o serviço Monitoring para criar consultas personalizadas.

Dimensões

As métricas do Management Gateway incluem as seguintes dimensões:

GATEWAYHOSTNAME: O nome do host no qual o gateway de gerenciamento está instalado.
RESOURCEID: O OCID do recurso do gateway de gerenciamento.

Métricas

Nome da Métrica	Nome para Exibição da Métrica	Unidade	Frequência	Descrição	Dimensões
`gatewayHealthStatus`	Status de Integridade do Gateway	Não Aplicável	1 minuto	Indica que o Gateway está se comunicando com sucesso com o serviço Monitoring. O valor de status é um número constante (1) para representar que o gateway está em funcionamento e pode fazer upload de métricas para o serviço Monitoring. Se o valor `gatewayHealthStatus` estiver ausente, isso significa que o gateway não pode fazer upload de métricas para o serviço Monitoring. O gateway propriamente dito pode estar ativo ou inativo nesse momento.	`gatewayHostName` `resourceId`
`diskUsageUsed`	Uso de Disco do Gateway	Megabytes	1 hora	Quantidade total de disco usada em "agent_inst".	`gatewayHostName` `resourceId`
`diskUsageFree`	Espaço em Disco Disponível no Gateway Disponível	Megabytes	1 hora	Volume de espaço em disco disponível no volume em que o gateway está instalado.	`gatewayHostName` `resourceId`
`diskUsageInstallSize`	Uso do Disco para Instalação	Megabytes	1 hora	Espaço total em disco usado sob o diretório base do gateway.	`gatewayHostName` `resourceId`
`usageCpu`	Utilização da CPU do Gateway	Porcentagem	1 minuto	O uso da CPU do gateway, expresso como uma porcentagem.	`gatewayHostName` `resourceId`
`usageRss`	Uso de Memória do Gateway	Megabytes	1 minuto	Volume de memória consumido pela JVM do gateway. O número representa o tamanho do conjunto residente na memória principal.	`gatewayHostName` `resourceId`
`uploadSent`	Dados Enviados	Bytes	10 minutos	Bytes submetidos a upload pelo gateway para o OCI.	`gatewayHostName` `resourceId`
`queueUsageDepth`	Uso da Fila de Buffer de Gateway	Contagem	10 minutos	Número de entradas atualmente aguardando na fila de upload em buffer.	`gatewayHostName` `resourceId` `queueName`
`uploadResponseTime`	Tempo de Resposta de Upload	Milissegundos	10 minutos	Tempo médio para o Gateway obter uma resposta do serviço do OCI para uploads armazenados no buffer, contado de quando o Gateway está conectado ao OCI.	`gatewayHostName` `resourceId` `serviceName`
`agentResponseTime`	Tempo de Resposta do Agente	Milissegundos	10 minutos	Tempo médio para o Gateway obter uma resposta do serviço do OCI para uploads armazenados no buffer, contado de quando o Agente está conectado ao Gateway.	`gatewayHostName` `resourceId` `agentId`
`uploadLatency`	Latência de Upload	Milissegundos	10 minutos	Tempo médio gasto dentro do próprio Gateway, ao processar uploads armazenados em buffer.	`gatewayHostName` `resourceId` `serviceName`
`associatedAgentCount`	Contagem de Agentes Associados	Contagem	10 minutos	Número de agentes distintos que fazem uploads armazenados no buffer desde a inicialização da instância.	`gatewayHostName` `resourceId` `agentType`
`incomingRequestCount`	Contagem de Solicitações Recebidas	contagem	10 minutos	Número de solicitações de upload armazenadas em buffer dos Agentes desde a inicialização da instância.	`gatewayHostName` `resourceId` `agentId`
`outgoingRequestCount`	Contagem de Solicitações Enviadas	contagem	10 minutos	Número de solicitações de upload armazenadas em buffer bem-sucedidas do Gateway para o OCI desde a inicialização da instância.	`gatewayHostName` `resourceId` `serviceName`

Observação

O intervalo de alarme deve ser maior que a frequência na qual as métricas são emitidas. Defina intervalos de alarme maiores que a frequência na qual as métricas são emitidas.

Usando a Console

Use a console para exibir gráficos das métricas emitidas pelo Management Gateway.

Exibir Métricas Padrão do Management Gateway

Para exibir as métricas padrão para um único Management Gateway, você pode usar Métricas do Serviço.

Abra o menu de navegação. Em Observabilidade e Gerenciamento, vá para Monitoring e clique em Métricas do Serviço.
Em Namespace de Métricas, selecione oci_managementgateway.
Em Dimensões, especifique resourceId e selecione o OCID do gateway de gerenciamento para o qual você deseja exibir métricas de serviço.

Criar Consultas de Métricas para o Management Gateway

Você pode criar consultas de métrica do Management Gateway para monitorar o status de integridade ou o consumo de recursos.

Por exemplo, você pode criar uma consulta usando o namespace oci_managementgateway, a métrica gatewayHealthStatus e a dimensão gatewayHostName para monitorar se o gateway está se comunicando com sucesso com o serviço Monitoring.

Abra o menu de navegação. Em Observabilidade e Gerenciamento, vá para Monitoring e clique em Métricas do Serviço.
Preencha os campos de uma nova consulta.
- Compartimento: Compartimento no qual o gateway de gerenciamento reside.
- Namespace de métricas: Selecione oci_managementgateway.
- Nome da métrica: Selecione uma métrica dentro do Namespace da Métrica selecionado.
- Intervalo: Selecione uma janela de agregação.
- Estatística: Selecione uma função de agregação.
- Dimensões de métricas: Selecione uma dimensão no campo Nome da dimensão e um valor para essa dimensão no campo Valor da dimensão. Opcionalmente, você pode adicionar outra dimensão.
Clique em Atualizar Gráfico.

O gráfico mostra os resultados da nova consulta.

Para obter informações sobre a criação de consultas de métrica, consulte Criando Consultas de Métricas.

Criar Alarmes para o Management Gateway

Você pode criar um alarme usando o serviço Monitoring a ser notificado se uma métrica do Management Gateway violar o limite especificado.

Por exemplo, para verificar se um gateway específico está se comunicando com o serviço Monitoring, você pode executar uma consulta usando o nome da métrica gatewayHealthStatus. Para monitorar esse gateway automaticamente, você pode criar um alarme para notificar o administrador se não houver comunicação por 10 minutos.

Os alarmes acionados podem ser vistos na página Status do Alarme:

Abra o menu de navegação. Em Observabilidade e Gerenciamento, vá para Monitoring e clique em Status do Alarme.

Para obter informações sobre como criar um alarme para métricas do Management Gateway, consulte Usando a Console para Criar um Alarme.

Usando a API

Para obter informações sobre como usar a API e assinar solicitações, consulte APIs REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte Kits de Desenvolvimento de Software e Interface de Linha de Comando.

Use as seguintes APIs para monitoramento:

API de Monitoramento para métricas e alarmes
API de Notificações para notificações (usada com alarmes)

Documentação do Oracle Cloud Infrastructure