Métricas Java para aplicativos Java nos Aplicativos de Contêiner do Azure

Artigo
10/16/2024

As métricas JVM (Máquina Virtual Java) são essenciais para monitorar a integridade e o desempenho de seus aplicativos Java. Os dados coletados incluem insights sobre uso de memória, coleta de lixo, contagem de threads de sua JVM. Use as métricas a seguir para ajudar a garantir a integridade e a estabilidade de seus aplicativos.

Métricas coletadas

Categoria	Title	Descrição	ID da métrica	Unidade
Java	`jvm.memory.total.used`	Quantidade total de memória usada por heap ou nonheap.	`JvmMemoryTotalUsed`	bytes
Java	`jvm.memory.total.committed`	Quantidade total de memória garantida para estar disponível para heap ou não.	`JvmMemoryTotalCommitted`	bytes
Java	`jvm.memory.total.limit`	Quantidade total de memória máxima obtêvel para heap ou nonheap	`JvmMemoryTotalLimit`	bytes
Java	`jvm.memory.used`	Quantidade de memória usada por cada pool	`JvmMemoryUsed`	bytes
Java	`jvm.memory.committed`	Quantidade de memória garantida para estar disponível para cada pool	`JvmMemoryCommitted`	bytes
Java	`jvm.memory.limit`	Quantidade máxima de memória obtêvel para cada pool	`JvmMemoryLimit`	bytes
Java	`jvm.buffer.memory.usage`	Quantidade de memória usada por buffers, como memória direta	`JvmBufferMemoryUsage`	bytes
Java	`jvm.buffer.memory.limit`	Quantidade total de capacidade de memória de buffers	`JvmBufferMemoryLimit`	bytes
Java	`jvm.buffer.count`	Número de buffers no pool de memória	`JvmBufferCount`	N/D
Java	`jvm.gc.count`	Contagem de ações de coleta de lixo JVM	`JvmGcCount`	N/D
Java	`jvm.gc.duration`	Duração das ações de coleta de lixo JVM	`JvmGcDuration`	milliseconds
Java	`jvm.thread.count`	Número de threads de plataforma em execução	`JvmThreadCount`	N/D

Configuração

Para disponibilizar a coleção de métricas Java para seu aplicativo, configure seu aplicativo de contêiner com algumas configurações específicas.

create
update

Na janela Criar, se você selecionar Origem da implantação a opção Imagem de contêiner, você terá acesso a recursos específicos da pilha.

Nos recursos específicos da pilha de desenvolvimento e para a Pilha de desenvolvimento, selecione Java.

Depois de selecionar a pilha de desenvolvimento java, a janela Personalizar Java para o aplicativo aparece. Ao lado do rótulo Recursos do Java, selecione Métricas principais do JVM

Há duas opções da CLI relacionadas ao runtime do aplicativo e às métricas Java:

Opção	Descrição
`--runtime`	O runtime do aplicativo de contêiner. Os valores com suporte são `generic` e `java`.
`--enable-java-metrics`	Uma opção booliana que habilita ou desabilita as métricas java para o aplicativo. Aplicável somente para o runtime do Java.

Observação

O parâmetro --enable-java-metrics=<true|false> define implicitamente --runtime=java. O parâmetro --runtime=generic redefine todas as informações de runtime do Java.

Habilitar métricas do Java

Você pode habilitar as métricas do Java por meio dos comandos create ou update.

create
update

az containerapp create \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --image <CONTAINER_IMAGE_LOCATION> \
  --enable-java-metrics=true

az containerapp update \ 
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --enable-java-metrics=true

Desabilitar métricas do Java

Você pode desabilitar as métricas do Java usando o comando up.

az containerapp up \ 
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --enable-java-metrics=false

Observação

O aplicativo de contêiner é reiniciado quando você atualiza o sinalizador de métricas Java.

Exibir métricas do Java

Use as etapas a seguir para exibir visualizações de métricas para seu aplicativo de contêiner.

Acesse o portal do Azure.
Vá para seu aplicativo de contêiner.
Na seção Monitoramento, selecione Métricas.

A partir daí, você receberá um gráfico que plota as métricas que você está acompanhando em seu aplicativo.

Você pode ver nomes de métrica Java no Azure Monitor, mas os conjuntos de dados são mostrados como vazios, a menos que o recurso esteja habilitado. Consulte a seção Configuração para saber como habilitá-la.

Próximas etapas

Monitorar logs com o Log Analytics

Compartilhar via