Todos os produtos
Search
Central de documentação

Simple Log Service:Coletar dados de métricas de servidores ClickHouse

Última atualização: Jul 03, 2026

Use o Telegraf para coletar dados de métricas de servidores ClickHouse e envie-os para um Metricstore no Simple Log Service por meio do Logtail. Assim, você monitora as métricas dos servidores ClickHouse visualmente. Este tópico descreve como coletar e visualizar dados de métricas de servidores ClickHouse com o Simple Log Service.

Pré-requisitos

  • O Telegraf deve estar instalado em um servidor conectado ao servidor ClickHouse por uma rede interna.

  • Crie um projeto e um Metricstore. Para mais informações, consulte Criar um projeto e Criar um Metricstore.

Limite

Somente o Logtail para Linux V0.16.48 ou superior coleta dados de métricas do ClickHouse. Se o servidor tiver uma versão anterior do Logtail, atualize-o para uma versão compatível. Para mais informações, consulte Instalar o Logtail em um servidor Linux.

Procedimento

  1. Faça login no console do Simple Log Service.

  2. Na seção Import Data, clique em ClickHouse Monitoring Data.

  3. Selecione o Project e o MetricStore desejados e clique em Next. Na etapa Select Log Space, escolha um Project e um MetricStore existentes ou clique em Create Now à direita para criar novos recursos. Em seguida, clique em Next.

  4. Na aba Create Machine Group:

    • Se já houver um grupo de máquinas disponível, clique em Use Existing Machine Groups. Selecione Host scenario e ECS. Na lista source machine group, escolha o grupo de máquinas desejado e clique em > para movê-lo para a lista applied machine group. Depois, clique em Next.

    • Se não houver grupos de máquinas disponíveis, siga as etapas abaixo para criar um. Neste exemplo, usa-se uma instância do Elastic Compute Service (ECS).

      1. Na aba ECS Instance, na seção Manually select instances, selecione a instância ECS desejada e clique em Create.

        Para mais informações, consulte Instalar o Logtail em instâncias ECS.

        Importante

        Para coletar logs de uma instância ECS pertencente a uma conta Alibaba Cloud diferente da usada pelo Simple Log Service, de um servidor em data center local ou de um provedor de nuvem terceirizado, instale o Logtail manualmente. Para mais informações, consulte Instalar o Logtail em um servidor Linux. Após a instalação manual, configure um identificador de usuário para o servidor. Para mais detalhes, consulte Configurar um identificador de usuário.

      2. Após concluir a instalação, clique em Complete Installation.

      3. Na página Create Machine Group, insira um Name e clique em Next.

        No Simple Log Service, é possível criar grupos de máquinas baseados em endereços IP ou em identificadores personalizados. Para mais informações, consulte Criar um grupo de máquinas.

  5. Verifique se o grupo de máquinas aparece na seção Applied Server Groups e clique em Next.

    Importante

    Ao aplicar um grupo de máquinas logo após a criação, o status de heartbeat pode aparecer como FAIL. Isso ocorre porque o grupo ainda não estabeleceu conexão com o Simple Log Service. Para resolver, clique em Automatic Retry. Se o problema persistir, consulte O que fazer quando nenhuma conexão de heartbeat é detectada no Logtail?

  6. Na etapa Specify Data Source, configure os parâmetros descritos na tabela a seguir.

    Parâmetro

    Descrição

    Configuration Name

    Nome da configuração do Logtail. Defina um nome personalizado.

    Cluster Name

    Nome personalizado para o cluster ClickHouse.

    Após definir este parâmetro, o Simple Log Service adiciona a tag cluster=YourClusterName às métricas coletadas do ClickHouse.

    Importante

    Cada nome de cluster deve ser único para evitar conflitos de dados.

    Username

    Nome de usuário para conexão com o banco de dados ClickHouse.

    Password

    Senha do usuário do banco de dados ClickHouse.

    Servers

    Detalhes de conexão com o banco de dados ClickHouse. Estão disponíveis os seguintes parâmetros:

    • Address: endpoint do banco de dados ClickHouse.

    • Port: número da porta do banco de dados ClickHouse. O valor padrão é 8123.

    Adicione vários servidores ClickHouse conforme a necessidade do seu negócio.

    Custom Tag

    Tags personalizadas para adicionar às métricas coletadas do ClickHouse. As tags são pares chave-valor.

    Ao configurar este parâmetro, o Simple Log Service aplica as tags especificadas a todas as métricas do ClickHouse coletadas por meio desta configuração.

    Custom Telegraf Configurations

    O Simple Log Service utiliza o Telegraf, um agente open-source, para coletar métricas do ClickHouse. Se os parâmetros padrão não atenderem aos seus requisitos, use o recurso Custom Telegraf Configurations para especificar configurações personalizadas. Para exemplos de configuração, consulte Configuration.

    Para obter a lista de métricas suportadas, acesse Metrics.

Perguntas frequentes

Como verificar se o Telegraf está coletando dados corretamente?

Consulte os logs no arquivo /etc/ilogtail/telegraf/telegraf.log do servidor. Também é possível enviar esse arquivo de log para o Log Service e pesquisar as informações necessárias.

Próximas etapas

  • Consultar e analisar dados

    Após configurar o ambiente, o Telegraf usa o Logtail para enviar os dados de métricas coletados para o Metricstore especificado no Simple Log Service. Consulte Consultar e analisar dados de métricas para saber como consultar e analisar esses dados no Metricstore.

  • Visualizar resultados de consultas e análises

    Depois de configurar o ambiente, o Simple Log Service cria automaticamente um painel chamado ClickHouse Monitoring Data_<Nome do cluster> no projeto associado. Use esse painel para visualizar os resultados das consultas e análises. Você também pode configurar regras de alerta diretamente nele.