Esta página foi traduzida pela API Cloud Translation.

Memcached

A integração do Memcached recolhe principalmente métricas de utilização da cache, como o número de itens numa cache, o número de remoções e o número de bytes armazenados. Também recolhe métricas de desempenho gerais para a utilização da CPU e a taxa de transferência da rede.

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

Pré-requisitos

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

Para métricas, instale a versão 2.8.0 ou superior.
Para registos, instale a versão 2.15.0 ou superior.

Esta integração suporta a versão 1.6 do Memcached.

Configure o agente de operações para o Memcached

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

Exemplo de configuração

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

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:
    memcached:
      type: memcached
  service:
    pipelines:
      memcached:
        receivers:
          - memcached
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*
```

Recolha registos

O Memcached 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 Memcached, tem de criar um recetor para as métricas que o Memcached 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 memcached, especifique os seguintes campos:

Campo	Predefinição	Descrição
`collection_interval`	`60s`	Um valor de duração, como `30s` ou `5m`.
`endpoint`	`localhost:3306`	O URL ou o caminho do ficheiro de socket Unix para o seu servidor Memcached.
`type`		Este valor tem de ser `memcached`.

O que é monitorizado

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

Tipo de métrica
Tipo, Tipo Recursos monitorizados	Etiquetas
`workload.googleapis.com/memcached.bytes`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/memcached.commands`
`CUMULATIVE`, `INT64` gce_instance	`command`
`workload.googleapis.com/memcached.connections.current`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/memcached.connections.total`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/memcached.cpu.usage`
`CUMULATIVE`, `DOUBLE` gce_instance	`state`
`workload.googleapis.com/memcached.current_items`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/memcached.evictions`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/memcached.network`
`CUMULATIVE`, `INT64` gce_instance	`direction`
`workload.googleapis.com/memcached.operations`
`CUMULATIVE`, `INT64` gce_instance	`operation` `type`
`workload.googleapis.com/memcached.threads`
`GAUGE`, `INT64` gce_instance

Valide a configuração

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

Para verificar se os registos do Memcached 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("syslog")
jsonPayload.message~=' (systemd-memcached-wrapper|memcached)([[0-9]+])*:'

Para verificar se as métricas do Memcached 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/memcached.bytes", monitored_resource="gce_instance"}
```

Ver o painel de controlo

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