Todos os produtos
Search

Este produto

    Simple Log Service:Coletar logs entre regiões com o Logtail

    Central de documentação

    Simple Log Service:Coletar logs entre regiões com o Logtail

    Última atualização: Jul 03, 2026

    Use o Logtail para coletar logs de servidores em diferentes regiões sob a mesma conta Alibaba Cloud. Este tópico usa um servidor Linux como exemplo.

    Como funciona

    Suponha que sua aplicação web esteja implantada na Região A e o projeto do Simple Log Service esteja na Região B. Para enviar dados de log de uma instância ECS na Região A para o projeto do Simple Log Service na Região B, siga estas etapas:

    A figura a seguir ilustra o processo.

    image

    Pré-requisitos

    Você deve ter um projeto e um Logstore criados. Para mais informações, consulte Gerencie projetos e Crie um Logstore.

    Etapa 1: Instale o Logtail na região A

    Transmissão de rede

    Modo de transmissão

    Caso de uso

    Internet

    • A instância ECS do Alibaba Cloud e o projeto SLS estão em regiões diferentes.

    • O servidor pertence a um provedor de nuvem terceirizado ou está em um data center local.

    transfer acceleration

    Se seus servidores estiverem em data centers locais ou hospedados por provedores de nuvem fora da China, a transmissão via Internet pode causar alta latência e conexões instáveis. Nesse caso, use o transfer acceleration. Para mais informações, consulte Gerencie aceleração de transferência.

    Faça login na instância ECS na região A. Selecione um script de instalação do Logtail conforme seu ambiente de rede, descrito em Transmissão de rede. Para visualizar a lista de sistemas operacionais Linux compatíveis com o Logtail, consulte Limites.

    Internet

    Obtenha o valor do parâmetro do Simple Log Service correspondente à região do projeto do Simple Log Service. Substitua o parâmetro ${region_id} pelo valor obtido e execute o comando de instalação.

    Importante

    Para obter detalhes sobre o valor do parâmetro ${region_id} de cada região, consulte Regiões suportadas. Por exemplo, o valor do parâmetro ${region_id} para a região de Singapura é ap-southeast-1.

    wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_id}-internet

    Transfer acceleration

    Obtenha o valor do parâmetro do Simple Log Service correspondente à região do projeto do Simple Log Service. Substitua o parâmetro ${region_id} pelo valor obtido e execute o comando de instalação.

    Importante 
    wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_id}-acceleration

    Etapa 2: Configure um identificador personalizado

    1. Crie o arquivo de identificador personalizado user_defined_id no diretório especificado e configure o identificador.

      Importante

      • Um grupo de Machine Groups não pode conter servidores Linux e Windows simultaneamente. Portanto, não atribua o mesmo Custom Identifier a servidores Linux e Windows.

      • Configure vários Custom Identifier para um único servidor. Separe os identificadores com quebras de linha.

    Linux

    1. Acesse o servidor Linux onde o Logtail está instalado e execute o comando abaixo para configurar o Custom Identifier.

      Nota

      Se o diretório /etc/ilogtail/ não existir, crie-o manualmente.

      echo "user-defined-1" > /etc/ilogtail/user_defined_id

    2. (Opcional) Execute o seguinte comando para verifique se o Custom Identifier foi gravado corretamente. Se user-defined-1 for retornado, a gravação foi bem-sucedida.

      cat /etc/ilogtail/user_defined_id

    3. As alterações no arquivo user_defined_id entram em vigor em até 1 minuto por padrão. Para aplicar as mudanças imediatamente, execute o comando a seguir para reiniciar o Logtail.

      /etc/init.d/ilogtaild stop
/etc/init.d/ilogtaild start

    Windows

    1. Acesse o servidor Windows onde o Logtail está instalado, crie um arquivo chamado user_defined_id no diretório C:\LogtailData, grave user-defined-1 nele e salve o arquivo.

      Nota

      Caso o diretório C:\LogtailData não exista, crie-o manualmente.

    2. Por padrão, as alterações no arquivo user_defined_id entram em vigor em até um minuto. Para aplicar as mudanças imediatamente, reinicie o Logtail:

      1. Escolha Start > Control Panel > Tools > Service.

      2. Na caixa de diálogo Service, selecione o serviço apropriado.

      3. Para o Logtail V0.x.x.x, selecione o serviço LogtailWorker.

      4. Para o Logtail V1.0.0.0 ou posterior, selecione o serviço LogtailDaemon.

      5. Clique em com o botão direito no serviço e selecione Restart.

    Ambientes de contêiner

    Defina o identificador personalizado na variável de ambiente ALIYUN_LOGTAIL_USER_DEFINED_ID do contêiner do Logtail. Execute o comando docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID para verifique a configuração.

    Etapa 3: Crie um grupo de máquinas com ID personalizado

    1. Faça login no console do Simple Log Service. Na seção Projects, clique em no projeto desejado.

    2. No painel de navegação à esquerda, escolha Resources > Machine Groups. Na lista de Machine Groups, escolha Machine Group > Create Machine Group.image

    3. No painel Create Machine Group, configure os parâmetros e clique em OK. A tabela a seguir descreve os parâmetros.

      Parâmetro

      Descrição

      Name

      O nome do grupo de máquinas deve atender aos seguintes requisitos:

      • Conter apenas letras minúsculas, dígitos, hifens (-) e sublinhados (_).

      • Começar e terminar com uma letra minúscula ou dígito.

      • Ter entre 2 e 128 caracteres.

      Importante

      Não é possível alterar o nome após a criação do grupo de máquinas. Proceda com cautela.

      Machine Group Identifier

      Tipo de identificador do grupo de máquinas. Selecione IP Address.

      Machine Group Topic

      Opcional. O tópico identifica os logs gerados por diferentes servidores.

      IP Address

      Endereço IP. Insira o endereço IP obtido automaticamente pelo Logtail.

      Importante

      • Para adicionar vários servidores a um grupo de máquinas, recomendamos inserir manualmente os endereços IP e separá-los com quebras de linha.

      • Um grupo de máquinas não pode incluir servidores Linux e Windows simultaneamente. Não adicione endereços IP de servidores Linux e Windows ao mesmo grupo de máquinas.

    4. Na lista de Machine Groups, clique em no grupo de máquinas desejado. Na página Machine Group Configurations, verifique a configuração do grupo de máquinas e o status de heartbeat do servidor.

    Etapa 4: Crie uma configuração do Logtail

    Importante

    • O host onde o Logtail está instalado deve permitir tráfego de saída nas portas 80 (http) e 443 (https). Em uma instância ECS, as regras de grupo de segurança controlam o acesso às portas. Para mais informações sobre como adicionar uma regra de grupo de segurança, consulte Adicionar uma regra de grupo de segurança.

    • O Logtail coleta apenas logs incrementais; portanto, o arquivo de log deve ser atualizado continuamente. O Logtail não coleta dados de arquivos que deixam de ser atualizados após a aplicação da configuração. Para mais informações, consulte Ler dados de log.

    • Para coletar dados históricos, consulte Importar arquivos de log históricos.

    Referências

    • Se a página de visualização estiver em branco ou a consulta não retornar dados durante a coleta com o Logtail, solucione o problema seguindo as instruções em Solucionar erros de coleta do Logtail. Erros podem ocorrer durante a coleta, como falhas na análise de expressões regulares, caminhos de arquivo inválidos ou tráfego acima da capacidade de processamento dos shards. Visualize os erros de coleta do Logtail seguindo as instruções em Como visualizar erros de coleta do Logtail?. Para mais informações sobre erros comuns na coleta de dados, consulte Erros comuns de coleta.

    • Por padrão, use apenas uma configuração do Logtail para coletar logs de um arquivo de log. Caso precise coletar várias cópias de logs de um mesmo arquivo, siga as instruções em Coletar logs de um arquivo várias vezes.

    • Para mais informações sobre como coletar logs de servidores em uma intranet corporativa para o Simple Log Service, consulte Coletar logs de servidores locais.