Esta página foi traduzida pela API Cloud Translation.

WildFly

A integração do WildFly recolhe registos do WildFly e analisa-os num payload JSON. O resultado inclui a origem, o código da mensagem, o nível e a mensagem.

Para mais informações sobre o WildFly, consulte a documentação do WildFly.

Pré-requisitos

Para recolher telemetria do WildFly, tem de instalar o agente de operações:

Para métricas, instale a versão 2.12.0 ou superior.
Para registos, instale a versão 2.11.0 ou superior.

Esta integração suporta as versões 26.x e 25.x do WildFly.

Configure a sua instância do WildFly

Para expor o ponto final JMX remotamente, tem de definir a propriedade do sistema jboss.bind.address.management. Por predefinição, esta propriedade está definida na configuração do WildFly. A instalação predefinida do WildFly não requer autenticação JMX com JMX exposto localmente em 127.0.0.1:9990.

Para recolher métricas de sessão, tem de ativar as estatísticas no subsistema undertow executando o seguinte comando através da JBoss CLI:

/subsystem=undertow:write-attribute(name=statistics-enabled,value=true)

Configure o agente de operações para o WildFly

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

Exemplo de configuração

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

# Configures Ops Agent to collect telemetry from the app. You must restart the agent for the configuration to take effect.

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:
    wildfly:
      type: wildfly
      endpoint: localhost:9990
  service:
    pipelines:
      wildfly:
        receivers:
          - wildfly

logging:
  receivers:
    wildfly_system:
      type: wildfly_system
  service:
    pipelines:
      wildfly_system:
        receivers:
          - wildfly_system
EOF

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

Linux

Para reiniciar o agente, execute o seguinte comando na sua instância:
```
sudo systemctl restart google-cloud-ops-agent
```
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

Estabeleça ligação à sua instância através do RDP ou de uma ferramenta semelhante e inicie sessão no Windows.
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
Para reiniciar o agente, execute o seguinte comando do PowerShell:
```
Restart-Service google-cloud-ops-agent -Force
```
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 registos

Para carregar registos do WildFly, tem de criar um recetor para os registos que o WildFly produz e, em seguida, criar um pipeline para o novo recetor.

Para configurar um recetor para os seus registos wildfly_system, especifique os seguintes campos:

Campo	Predefinição	Descrição
`exclude_paths`		Uma lista de padrões de caminhos do sistema de ficheiros a excluir do conjunto correspondente a `include_paths`.
`include_paths`	`[/opt/wildfly/standalone/log/server.log, /opt/wildfly/domain/servers/*/log/server.log]`	Uma lista de caminhos do sistema de ficheiros a ler através da análise detalhada de cada ficheiro. Pode usar um caráter universal (``) nos caminhos; por exemplo, `/var/log/wildfly/*.log`.
`record_log_file_path`	`false`	Se estiver definido como `true`, o caminho para o ficheiro específico a partir do qual o registo de registo foi obtido aparece na entrada de registo de saída como o valor da etiqueta `agent.googleapis.com/log_file_path`. Quando usa um caráter universal, apenas é registado o caminho do ficheiro a partir do qual o registo foi obtido.
`type`		O valor tem de ser `wildfly_system`.
`wildcard_refresh_interval`	`60s`	O intervalo no qual os caminhos de ficheiros com carateres universais em `include_paths` são atualizados. Indicado como uma duração, por exemplo, `30s` ou `2m`. Esta propriedade pode ser útil em débitos de registo elevados, em que os ficheiros de registo são rodados mais rapidamente do que o intervalo predefinido.

O que é registado

O logName é derivado dos IDs dos recetores especificados na configuração. Os campos detalhados no interior de LogEntry são os seguintes.

Os registos wildfly_system contêm os seguintes campos em LogEntry:

Campo	Tipo	Descrição
`jsonPayload.level`	de string	Nível de entrada do registo
`jsonPayload.message`	de string	Mensagem de registo
`jsonPayload.messageCode`	de string	Código de mensagem específico do Wildfly que precede o registo, quando aplicável
`jsonPayload.source`	de string	Origem do registo
`jsonPayload.thread`	de string	Discussão onde o registo teve origem
`severity`	string (`LogSeverity`)	Nível de entrada de registo (traduzido).

Configure a recolha de métricas

Para carregar métricas do WildFly, tem de criar um recetor para as métricas que o WildFly produz 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 wildfly, especifique os seguintes campos:

Campo	Predefinição	Descrição
`additional_jars`	`/opt/wildfly/bin/client/jboss-client.jar`	O caminho para o ficheiro `jboss-client.jar`, que é necessário para monitorizar o WildFly através do JMX.
`collection_interval`	`60s`	Um valor de duração, como `30s` ou `5m`.
`endpoint`	`service:jmx:remote+http://localhost:9990`	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 `wildfly`.
`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 do WildFly.

Tipo de métrica
Tipo, Tipo Recursos monitorizados	Etiquetas
`workload.googleapis.com/wildfly.jdbc.connection.open`
`GAUGE`, `INT64` gce_instance	`data_source` `state`
`workload.googleapis.com/wildfly.jdbc.request.wait`
`CUMULATIVE`, `INT64` gce_instance	`data_source`
`workload.googleapis.com/wildfly.jdbc.rollback.count`
`CUMULATIVE`, `INT64` gce_instance	`cause`
`workload.googleapis.com/wildfly.jdbc.transaction.count`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/wildfly.network.io`
`CUMULATIVE`, `INT64` gce_instance	`listener` `server` `state`
`workload.googleapis.com/wildfly.request.count`
`CUMULATIVE`, `INT64` gce_instance	`listener` `server`
`workload.googleapis.com/wildfly.request.server_error`
`CUMULATIVE`, `INT64` gce_instance	`listener` `server`
`workload.googleapis.com/wildfly.request.time`
`CUMULATIVE`, `INT64` gce_instance	`listener` `server`
`workload.googleapis.com/wildfly.session.active`
`GAUGE`, `INT64` gce_instance	`deployment`
`workload.googleapis.com/wildfly.session.count`
`CUMULATIVE`, `INT64` gce_instance	`deployment`
`workload.googleapis.com/wildfly.session.expired`
`CUMULATIVE`, `INT64` gce_instance	`deployment`
`workload.googleapis.com/wildfly.session.rejected`
`CUMULATIVE`, `INT64` gce_instance	`deployment`

Valide a configuração

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

Para verificar se os registos do WildFly estão a ser enviados para o Cloud Logging, faça o seguinte:

Na Google Cloud consola, aceda à página Explorador de registos:
Aceda ao Explorador de registos

Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.
Introduza a seguinte consulta no editor e, de seguida, clique em Executar consulta:
```
resource.type="gce_instance"
log_id("wildfly_system")
```

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

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.
Na barra de ferramentas do painel do criador de consultas, selecione o botão cujo nome é MQL ou PromQL.
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.

Introduza a seguinte consulta no editor e, de seguida, clique em Executar consulta:

{"workload.googleapis.com/wildfly.network.io", monitored_resource="gce_instance"}

Ver o painel de controlo

Para ver as métricas do WildFly, tem de ter um gráfico ou um painel de controlo configurado. A integração do WildFly 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:

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.
Selecione o separador Lista de painéis de controlo e, de seguida, escolha a categoria Integrações.
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:

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.
Clique no filtro da plataforma de implementação Compute Engine.
Localize a entrada para WildFly e clique em Ver detalhes.
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 do WildFly 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:

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.
Localize a entrada para WildFly e clique em Ver detalhes.
Selecione o separador Alertas. Este separador apresenta descrições das políticas de alerta disponíveis e uma interface para as instalar.
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.