Aerospike

A integração do Aerospike recolhe métricas importantes do espaço de nomes e do sistema, como a utilização do disco e da memória, as análises e as ligações. A integração recolhe estas métricas através da API de cliente oficial fornecida pela Aerospike.

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

Pré-requisitos

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

  • Para métricas, instale a versão 2.18.2 ou superior.
  • Para registos, instale a versão 2.23.0 ou superior.

Esta integração suporta as versões 4.9, 5.x e 6.x do Aerospike.

Configure a sua instância do Aerospike

Os registos do Aerospike são carregados automaticamente em sistemas onde o Aerospike é executado como um serviço systemd. Noutros sistemas, como o SLES, pode configurar manualmente um recetor files que aponte para o ficheiro de registo do Aerospike, que normalmente se encontra em $HOME/aerospike-server/var/log/aerospike.log.

Configure o agente de operações para o Aerospike

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

Exemplo de configuração

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

# 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:
    aerospike:
      type: aerospike
  service:
    pipelines:
      aerospike:
        receivers:
          - aerospike
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*

Recolha registos

O Aerospike escreve registos em syslog, que são capturados pelo agente de operações por predefinição. Não é necessária nenhuma configuração adicional do utilizador.

Configure a recolha de métricas

Para carregar métricas do Aerospike, tem de criar um recetor para as métricas produzidas pelo Aerospike 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 aerospike, especifique os seguintes campos:

Campo Predefinição Descrição
collect_cluster_metrics true Configura o recetor para recolher métricas de nós pares do sistema Aerospike.
collection_interval 60s Um valor de duração, como 30s ou 5m.
endpoint localhost:3000 Endereço do sistema Aerospike, formatado como anfitrião:porta.
password A palavra-passe configurada se o Aerospike estiver configurado para exigir autenticação.
timeout 20s Tempo limite para pedidos ao sistema Aerospike, um valor de duração, como 30s ou 5m.
type aerospike Este valor tem de ser aerospike.
username O nome de utilizador configurado se o Aerospike 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 Aerospike.

Tipo de métrica
Tipo, Tipo
Recursos monitorizados		 Etiquetas
workload.googleapis.com/aerospike.namespace.disk.available
GAUGE, INT64
gce_instance 		namespace_name
node_name
workload.googleapis.com/aerospike.namespace.memory.free
GAUGE, INT64
gce_instance 		namespace_name
node_name
workload.googleapis.com/aerospike.namespace.memory.usage
GAUGE, INT64
gce_instance 		component
namespace_name
node_name
workload.googleapis.com/aerospike.namespace.scan.count
CUMULATIVE, INT64
gce_instance 		namespace_name
node_name
result
type
workload.googleapis.com/aerospike.namespace.transaction.count
CUMULATIVE, INT64
gce_instance 		namespace_name
node_name
result
type
workload.googleapis.com/aerospike.node.connection.count
CUMULATIVE, INT64
gce_instance 		node_name
operation
type
workload.googleapis.com/aerospike.node.connection.open
GAUGE, INT64
gce_instance 		node_name
type
workload.googleapis.com/aerospike.node.memory.free
GAUGE, INT64
gce_instance 		node_name

Valide a configuração

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

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

  1. 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.

  2. Introduza a seguinte consulta no editor e, de seguida, clique em Executar consulta: 
    resource.type="gce_instance"
log_id("syslog")
jsonPayload.message~=' asd([[0-9]+])*:'

Para verificar se as métricas do Aerospike 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/aerospike.node.connection.open", monitored_resource="gce_instance"}

Ver o painel de controlo

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