JVM

A integração da JVM recolhe métricas da JVM expostas através das Java Management Extensions (JMX). A integração recolhe principalmente métricas sobre a memória e a recolha de lixo. Também estão disponíveis métricas de tempo de execução adicionais, como o número de threads e as classes carregadas.

Para mais informações sobre a JVM, consulte a documentação da JVM.

Pré-requisitos

Para recolher telemetria da JVM, tem de instalar o agente de operações:

• Para métricas, instale a versão 2.2.0 ou superior.

Esta integração suporta as versões JVM Java 16 e Java 11.

Configure a sua instância da JVM

Para expor um ponto final JMX, tem de definir a propriedade do sistema com.sun.management.jmxremote.port quando iniciar a JVM. Também recomendamos que defina a propriedade do sistema com.sun.management.jmxremote.rmi.port para a mesma porta.

Para expor um ponto final JMX remotamente, também tem de definir a propriedade do sistema java.rmi.server.hostname.

Para definir propriedades do sistema através de argumentos da linha de comandos, adicione -D antes do nome da propriedade ao iniciar a JVM.

Por exemplo, para definir com.sun.management.jmxremote.port para a porta 9999, especifique o seguinte ao iniciar a JVM:

-Dcom.sun.management.jmxremote.port=9999

Configure o agente de operações para a JVM

Seguindo o guia para configurar o Ops Agent, adicione os elementos necessários para recolher telemetria de instâncias da JVM e reinicie o agente.

Exemplo de configuração

Os seguintes comandos criam a configuração para recolher e carregar telemetria para a JVM:

set -e

# Check if the file exists
if [ ! -f /etc/google-cloud-ops-agent/config.yaml ]; then
  # Create the file if it doesn't exist.
  sudo mkdir -p /etc/google-cloud-ops-agent
  sudo touch /etc/google-cloud-ops-agent/config.yaml
fi

# Create a back up of the existing file so existing configurations are not lost.
sudo cp /etc/google-cloud-ops-agent/config.yaml /etc/google-cloud-ops-agent/config.yaml.bak

# Configure the Ops Agent.
sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
metrics:
  receivers:
    jvm:
      type: jvm
      endpoint: service:jmx:rmi:///jndi/rmi://127.0.0.1:9010/jmxrmi
  service:
    pipelines:
      jvm:
        receivers:
          - jvm
EOF

Para que estas alterações entrem em vigor, tem de reiniciar o agente de operações:

Linux

1. Para reiniciar o agente, execute o seguinte comando na sua instância:

   sudo systemctl restart google-cloud-ops-agent
   

2. Para confirmar que o agente foi reiniciado, execute o seguinte comando e verifique se os componentes "Agente de métricas" e "Agente de registo" foram iniciados:

   sudo systemctl status "google-cloud-ops-agent*"
   

Windows

1. Estabeleça ligação à sua instância através do RDP ou de uma ferramenta semelhante e inicie sessão no Windows.
2. Abra um terminal do PowerShell com privilégios de administrador: clique com o botão direito do rato no ícone do PowerShell e selecione Executar como administrador
3. Para reiniciar o agente, execute o seguinte comando do PowerShell:

   Restart-Service google-cloud-ops-agent -Force
   

4. Para confirmar que o agente foi reiniciado, execute o seguinte comando e verifique se os componentes "Agente de métricas" e "Agente de registo" foram iniciados:

   Get-Service google-cloud-ops-agent*
   

Configure a recolha de métricas

Para carregar métricas da JVM, tem de criar um recetor para as métricas produzidas pela JVM e, em seguida, criar um pipeline para o novo recetor.

Este recetor não suporta a utilização de várias instâncias na configuração, por exemplo, para monitorizar vários pontos finais. Todas essas instâncias escrevem na mesma série cronológica e o Cloud Monitoring não tem forma de as distinguir.

Para configurar um destinatário para as suas métricas jvm, especifique os seguintes campos:

Campo	Predefinição	Descrição
collection_interval	60s	Um valor de duração, como 30s ou 5m.
endpoint	localhost:9999	O URL do serviço JMX ou o anfitrião e a porta usados para criar o URL do serviço. Este valor tem de estar no formato service:jmx:<protocol>:<sap> ou host:port. Os valores no formato host:port são usados para criar um URL de serviço de service:jmx:rmi:///jndi/rmi://<host>:<port>/jmxrmi.
password		A palavra-passe configurada se o JMX estiver configurado para exigir autenticação.
type		Este valor tem de ser jvm.
username		O nome de utilizador configurado se o JMX estiver configurado para exigir autenticação.

O que é monitorizado

A tabela seguinte apresenta a lista de métricas que o agente de operações recolhe da instância da JVM.

Tipo de métrica
Tipo, Tipo Recursos monitorizados	Etiquetas
workload.googleapis.com/jvm.classes.loaded
GAUGE, INT64 gce_instance
workload.googleapis.com/jvm.gc.collections.count
CUMULATIVE, INT64 gce_instance	name
workload.googleapis.com/jvm.gc.collections.elapsed
CUMULATIVE, INT64 gce_instance	name
workload.googleapis.com/jvm.memory.heap.committed
GAUGE, INT64 gce_instance
workload.googleapis.com/jvm.memory.heap.init
GAUGE, INT64 gce_instance
workload.googleapis.com/jvm.memory.heap.max
GAUGE, INT64 gce_instance
workload.googleapis.com/jvm.memory.heap.used
GAUGE, INT64 gce_instance
workload.googleapis.com/jvm.memory.nonheap.committed
GAUGE, INT64 gce_instance
workload.googleapis.com/jvm.memory.nonheap.init
GAUGE, INT64 gce_instance
workload.googleapis.com/jvm.memory.nonheap.max
GAUGE, INT64 gce_instance
workload.googleapis.com/jvm.memory.nonheap.used
GAUGE, INT64 gce_instance
workload.googleapis.com/jvm.memory.pool.committed
GAUGE, INT64 gce_instance	name
workload.googleapis.com/jvm.memory.pool.init
GAUGE, INT64 gce_instance	name
workload.googleapis.com/jvm.memory.pool.max
GAUGE, INT64 gce_instance	name
workload.googleapis.com/jvm.memory.pool.used
GAUGE, INT64 gce_instance	name
workload.googleapis.com/jvm.threads.count
GAUGE, INT64 gce_instance

Valide a configuração

Esta secção descreve como verificar se configurou corretamente o recetor JVM. O agente de operações pode demorar um ou dois minutos a começar a recolher telemetria.

Para verificar se as métricas da JVM estão a ser enviadas para o Cloud Monitoring, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Explorador de métricas:

   Aceda ao Metrics Explorer

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

2. Na barra de ferramentas do painel do criador de consultas, selecione o botão cujo nome é  MQL ou  PromQL.
3. Verifique se a opção PromQL está selecionada no botão Idioma. O botão para alternar o idioma encontra-se na mesma barra de ferramentas que lhe permite formatar a consulta.
4. Introduza a seguinte consulta no editor e, de seguida, clique em Executar consulta:
   

   {"workload.googleapis.com/jvm.memory.heap.used", monitored_resource="gce_instance"}
   

Ver o painel de controlo

Para ver as métricas da JVM, tem de ter um gráfico ou um painel de controlo configurado. A integração da JVM inclui um ou mais painéis de controlo para si. Todos os painéis de controlo são instalados automaticamente depois de configurar a integração e o agente de operações começar a recolher dados de métricas.

Também pode ver pré-visualizações estáticas de painéis de controlo sem instalar a integração.

Para ver um painel de controlo instalado, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Painéis de controlo:

   Aceda a Painéis de controlo

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

2. Selecione o separador Lista de painéis de controlo e, de seguida, escolha a categoria Integrações.
3. Clique no nome do painel de controlo que quer ver.

Se configurou uma integração, mas o painel de controlo não foi instalado, verifique se o agente de operações está em execução. Quando não existem dados de métricas para um gráfico no painel de controlo, a instalação do painel de controlo falha. Depois de o agente de operações começar a recolher métricas, o painel de controlo é instalado para si.

Para ver uma pré-visualização estática do painel de controlo, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Integrações:

   Aceda a Integrações

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

2. Clique no filtro da plataforma de implementação Compute Engine.
3. Localize a entrada para JVM e clique em Ver detalhes.
4. Selecione o separador Painéis de controlo para ver uma pré-visualização estática. Se o painel de controlo estiver instalado, pode navegar até ele clicando em Ver painel de controlo.

Para mais informações acerca dos painéis de controlo no Cloud Monitoring, consulte o artigo Painéis de controlo e gráficos.

Para mais informações sobre como usar a página Integrações, consulte o artigo Gerir integrações.

Instale políticas de alerta

As políticas de alerta indicam ao Cloud Monitoring que lhe envie uma notificação quando ocorrerem condições especificadas. A integração da JVM inclui uma ou mais políticas de alerta para sua utilização. Pode ver e instalar estas políticas de alerta na página Integrações em Monitorização.

Para ver as descrições das políticas de alerta disponíveis e instalá-las, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Integrações:

   Aceda a Integrações

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

2. Localize a entrada para JVM e clique em Ver detalhes.
3. Selecione o separador Alertas. Este separador apresenta descrições das políticas de alerta disponíveis e uma interface para as instalar.
4. Instale políticas de alerta. As políticas de alerta precisam de saber para onde enviar notificações de que o alerta foi acionado, pelo que requerem informações suas para a instalação. Para instalar políticas de alerta, faça o seguinte:
   1. Na lista de políticas de alerta disponíveis, selecione as que quer instalar.

   2. Na secção Configurar notificações, selecione um ou mais canais de notificação. Tem a opção de desativar a utilização de canais de notificação, mas, se o fizer, as suas políticas de alerta são acionadas silenciosamente. Pode verificar o respetivo estado em Monitorização, mas não recebe notificações.

      Para mais informações sobre os canais de notificação, consulte o artigo Faça a gestão dos canais de notificação.

   3. Clique em Criar políticas.

Para mais informações sobre as políticas de alerta no Cloud Monitoring, consulte o artigo Introdução aos alertas.

Para mais informações sobre como usar a página Integrações, consulte o artigo Gerir integrações.

O que se segue?

Para ver um passo a passo sobre como usar o Ansible para instalar o agente de operações, configurar uma aplicação de terceiros e instalar um painel de controlo de exemplo, consulte o vídeo Instale o agente de operações para resolver problemas de aplicações de terceiros.