Todos os produtos
Search

Este produto

    Simple Log Service:Instalar o LoongCollector

    Central de documentação

    Simple Log Service:Instalar o LoongCollector

    Última atualização: Jun 23, 2026

    O LoongCollector é o agente de coleta de logs do Simple Log Service (SLS). Para coletar logs de servidores Linux, você deve primeiro instalar o LoongCollector neles.

    Limitações

    Sistemas operacionais Linux compatíveis

    • Os seguintes sistemas operacionais Linux de 64 bits (x86-64) são compatíveis:

      • Alibaba Cloud Linux 2 e 3

      • Anolis OS 7 e 8

      • CentOS 6, 7 e 8

      • Debian 8, 9, 10, 11 e 12

      • Red Hat Enterprise Linux 6, 7, 8 e 9

      • openSUSE 15.1, 15.2 e 42.3

      • SUSE Linux Enterprise Server 11, 12 e 15

      • Ubuntu 14.04, 16.04, 18.04, 20.04, 22.04 e 24.04

      • Outros sistemas operacionais Linux baseados no glibc 2.6 ou posterior

      • A CPU deve ser compatível com os conjuntos de instruções SSE4.2 e AVX.

    • Os seguintes sistemas operacionais Linux ARM de 64 bits são compatíveis:

      • Alibaba Cloud Linux 3.2 para ARM

      • Anolis OS 8.2 para ARM ou posterior

      • CentOS 8.4 para ARM

      • Debian 11.2 e 12.2 para ARM

      • Ubuntu 20.04, 22.04 e 24.04 para ARM

      • A arquitetura da CPU deve ser ARMv8.2-A ou posterior.

    Pré-requisitos

    Permissões

    Fazer login no console do Alibaba Cloud com uma conta root concede as permissões necessárias por padrão.

    Se você for um usuário do RAM, solicite ao proprietário da conta root as seguintes políticas do sistema para obter as permissões necessárias para gerenciar recursos do SLS, ECS e Operation Orchestration Service (OOS).

    • AliyunLogFullAccess: concede permissões totais para gerenciar o SLS.

    • AliyunOOSFullAccess: concede permissões totais para gerenciar o OOS. Necessário para usar o OOS na instalação automatizada do LoongCollector.

    • AliyunECSFullAccess: concede permissões totais para gerenciar o ECS. Necessário para usar o Cloud Assistant na instalação em lote do LoongCollector.

    Se as políticas padrão do sistema não atenderem aos seus requisitos, você pode criar uma política personalizada para um controle de acesso mais refinado. Para mais informações, consulte o exemplo a seguir.

    Substitua ${projectName} no campo Resource pelo nome do seu projeto.
    {
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ecs:DescribeTagKeys",
        "ecs:DescribeTags",
        "ecs:DescribeInstances",
        "ecs:DescribeInvocationResults",
        "ecs:RunCommand",
        "ecs:DescribeInvocations",
        "ecs:InvokeCommand"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "oos:ListTemplates",
        "oos:StartExecution",
        "oos:ListExecutions",
        "oos:GetExecutionTemplate",
        "oos:ListExecutionLogs",
        "oos:ListTaskExecutions"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:ListProject",
        "log:GetAcceleration",
        "log:ListDomains",
        "log:GetLogging",
        "log:ListTagResources"
      ],
      "Resource": [
        "acs:log:*:*:project/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:GetProject"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:ListLogStores",
        "log:GetLogStore",
        "log:GetLogStoreHistogram",
        "log:GetIndex",
        "log:CreateIndex",
        "log:UpdateIndex",
        "log:ListShards",
        "log:GetCursorOrData",
        "log:ListSavedSearch",
        "log:GetLogStoreLogs",
        "log:ListDashboard",
        "log:GetLogStoreContextLogs"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:*"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}/logtailconfig/*",
        "acs:log:*:*:project/${projectName}/machinegroup/*"
      ]
    }
  ]
}

    Criar um projeto

    Se você não tiver um projeto disponível, siga estas etapas para criar um projeto básico. Para obter detalhes sobre a configuração de criação, consulte Gerenciar projetos.

    Faça login no console do SLS, e clique em Create Project. Configure os seguintes parâmetros e mantenha os valores padrão para as outras configurações:

    • Region: selecione uma região do Alibaba Cloud com base na origem dos seus logs. Essa configuração não pode ser alterada após a criação do projeto.

    • Project Name: insira um nome para o projeto. O nome deve ser globalmente exclusivo na região selecionada do Alibaba Cloud e não pode ser alterado após a criação.

    Criar um Logstore

    Se você não tiver um Logstore disponível, crie um básico. Para mais informações sobre os detalhes de configuração, consulte Gerenciar Logstore.

    1. Faça login no console do SLS. Na lista de projetos, clique no projeto desejado.

    2. Na Log Storage seção, acesse a Logstores guia e clique no + ícone.

    3. Insira um Logstore Name e mantenha os valores padrão para os outros parâmetros.

    Requisitos de rede do servidor

    1. O servidor onde o LoongCollector está instalado deve permitir tráfego de saída nas portas 80 (HTTP) e 443 (HTTPS) para uploads de dados.

    2. O servidor deve ser capaz de se conectar ao endpoint do SLS. Para verificar a conectividade, siga estas etapas:

      1. Faça login no console do SLS. Na lista de projetos, clique no projeto desejado.

      2. Clique no image ícone ao lado do nome do projeto para acessar a Project Overview página.

      3. Na Endpoint seção, visualize as informações de endpoint do projeto. Em seguida, substitua as variáveis no comando a seguir e execute-o.

        curl https://${project_name}.${endpoint}

      4. Uma resposta semelhante a {"Error":{"Code":"OLSInvalidMethod","Message":"The script name is invalid : /","RequestId":"5D****09"}} indica que a conexão de rede está normal. Caso contrário, verifique seu firewall, a configuração de DNS e as configurações do grupo de segurança.

        Esse erro é esperado porque a URL da solicitação não possui os parâmetros necessários. Este teste verifica apenas a conectividade de rede e não usa uma URL de solicitação completa.

    Escolher um método de instalação

    Método de instalação

    Cenário

    Mesma conta e região

    O servidor é uma instância do ECS na mesma conta e região do projeto.

    Mesma conta, região diferente

    O servidor é uma instância do ECS na mesma conta do projeto, mas em uma região diferente..

    Contas diferentes, mesma região

    O servidor é uma instância do ECS na mesma região do projeto, mas em uma conta diferente.

    Outras plataformas de nuvem ou servidores locais

    • O servidor não é uma instância do ECS do Alibaba Cloud, como um servidor local ou um servidor de outro provedor de nuvem.

    • O servidor é uma instância do ECS do Alibaba Cloud, mas a instância e o projeto pertencem a contas diferentes do Alibaba Cloud e estão em regiões. Nesse caso, a instância do ECS é tratada como um servidor local.

    Mesma conta e região

    Se a sua instância do ECS e o projeto estiverem na mesma conta e região, você pode usar a instalação com um clique. O SLS usa o OOS para automatizar a instalação, portanto, você não precisa fazer login na instância manualmente.

    O recurso de instalação com um clique está integrado aos modelos de coleta de dados do SLS. O SLS fornece vários modelos de log de texto, como modelos de linha única, multilinha e baseados em regex. Esses modelos diferem apenas em seus plug-ins de processamento. Você pode adicionar ou remover plug-ins de processamento em um modelo. Selecione um modelo com base nas características dos logs que deseja coletar ou selecione qualquer modelo de log de texto e configure os plug-ins de processamento com base nas características do seu log.

    Procedimento

    1. Faça logon no console do SLS. Na lista de projetos, clique no projeto desejado.

    2. No painel de navegação à esquerda, escolha imageLog Storage > Logstores. Clique no image ícone ao lado do nome do Logstore desejado.

    3. Clique no image ícone ao lado de Data Collection, selecione o modelo de importação Single-line - Text Log na caixa de diálogo pop-up e clique em Integrate Now.

    4. Clique em Create Machine Group. Selecione uma ou mais instâncias do ECS que estejam na mesma região do projeto e clique em Install and Create Machine Group.

    5. Aguarde a conclusão da instalação, insira um nome e clique em OK. Se a instalação falhar, clique em Recreate Installation Task e selecione novamente as instâncias do ECS. Certifique-se de que as instâncias do ECS selecionadas estejam na mesma região do projeto.

    6. Clique em Next. Se o status do heartbeat for FAIL, clique em Automatic Retry e aguarde cerca de dois minutos até que o status mude para OK.

    7. A instalação com um clique está concluída. Clique em Next para criar uma configuração de coleta.

    Mesma conta, região diferente

    Se o servidor for uma instância do Alibaba Cloud ECS, e a instância e o projeto pertencerem à mesma conta do Alibaba Cloud, mas estiverem em regiõesdiferentes, você precisará baixar manualmente o pacote de instalação e usar transmissão de dados pela internet ou aceleração de transferência no comando de instalação.

    Procedimento

    1. Baixe o pacote de instalação. Execute o comando de download no servidor. No código de exemplo, você pode substituir ${region_id} por cn-hangzhou. Para acelerar o download, substitua ${region_id} pelo Region ID da região onde a instância do ECS reside.

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    2. Selecione um método de transmissão e execute o comando de instalação. Substitua ${region_id} pelo Region ID da região onde o projeto reside.

      • Internet: Este método é adequado para a maioria dos cenários, como implantações entre regiões e coleta de dados de outras plataformas em nuvem ou servidores locais. No entanto, está sujeito a limites de largura de banda e possível instabilidade.

        chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-internet

      • Aceleração de transferência: Este método é usado para transmissão de dados entre regiões, como de uma região na China continental para uma região fora da China continental. Ele usa a Content Delivery Network (CDN) para acelerar a transmissão de dados e melhorar o desempenho, o que evita alta latência e instabilidade na internet. No entanto, este método incorre em taxas de transferência de dados.

        Você deve habilitar o recurso de aceleração de transferência entre regiões para o projeto antes de executar o comando de instalação.
        chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-acceleration

    3. Verifique o status de inicialização. Se loongcollector is running for retornado, o agente foi iniciado.

      sudo /etc/init.d/loongcollectord status

    4. Configure um grupo de máquinas. O SLS usa grupos de máquinas para descobrir identificadores personalizados e estabelecer conexões de heartbeat com o LoongCollector nos hosts.

      1. No servidor, grave uma string personalizada como user-defined-test-1 no arquivo de identificador personalizado. Esta string será usada em uma etapa posterior.

        # Write a custom string to the specified file. If the directory does not exist, create it manually. The file path and name are fixed by SLS and cannot be changed.
echo "user-defined-test-1" > /etc/ilogtail/user_defined_id

      2. Faça logon no console do SLS. Na lista de projetos, clique no projeto desejado.

      3. No painel de navegação à esquerda, escolha imageResources > Machine Groups.

      4. Clique no image ícone ao lado de Machine Groupse clique em Create Machine Group.

      5. Configure os seguintes parâmetros e clique em OK.

        • Machine Group Name: Insira um nome para o grupo de máquinas. Ele deve ser exclusivo no projeto, ter de 3 a 128 caracteres, começar e terminar com uma letra minúscula ou um dígito e conter apenas letras minúsculas, dígitos, hifens (-) e sublinhados (_).

        • Machine Group Identifier: Selecione Custom Identifier.

        • Custom identifier: Insira o identificador que corresponde à string personalizada no arquivo de identificador personalizado no servidor. Por exemplo, user-defined-test-1.

    5. Após a criação do grupo de máquinas, clique no grupo de máquinas de destino na lista de grupos de máquinas para verificar o Heartbeat status. Se o status for FAIL, aguarde cerca de dois minutos e atualize manualmente. Um status OK significa que o grupo de máquinas foi criado com sucesso.

    6. Após a instalação, crie uma configuração de coleta para coletar logs.

    Contas diferentes na mesma região

    Se o seu servidor for uma instância do Alibaba Cloud ECS, e a instância e o projeto estiverem na mesma região , mas pertencerem a contas diferentes do Alibaba Cloud, você precisará baixar manualmente o pacote de instalação. Use o método de transmissão de rede interna no comando de instalação e configure um ID de usuário.

    Siga estas etapas:

    1. Baixe o pacote de instalação. Execute o comando de download no servidor. No código de exemplo, você pode substituir ${region_id} por cn-hangzhou. Para acelerar o download, consulte Region ID e substitua ${region_id} pela região da instância do ECS.

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    2. Execute o comando de instalação. Substitua ${region_id} pelo Region ID do projeto.

      Se ocorrer um tempo limite de conexão, você pode ter usado o ${region_id}errado. A rede interna não pode estabelecer uma conexão entre regiões diferentes. Corrija o Region ID e execute o comando de instalação novamente.
      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}

    3. Verifique o status de inicialização. Execute o comando. Se loongcollector is running for retornado, a inicialização foi bem-sucedida.

      sudo /etc/init.d/loongcollectord status

    4. Configure o ID de usuário. O arquivo de ID de usuário contém o ID da conta raiz do Alibaba Cloud proprietária do projeto. Esse ID indica que a conta tem permissão para acessar e coletar logs deste servidor.

      Configure um ID de usuário apenas ao coletar logs de instâncias ECS de outra conta, servidores autogerenciados ou servidores de outros provedores de nuvem. Se várias contas coletarem logs do mesmo servidor, crie vários arquivos de ID de usuário nesse servidor.

      1. Faça logon no console do SLS. Passe o ponteiro do mouse sobre a foto do perfil no canto superior direito. Na guia que aparece, visualize e copie o ID da conta. Certifique-se de copiar o ID da conta raiz.

      2. No servidor onde o LoongCollector está instalado, crie um arquivo de ID de usuário. Use o ID da conta raiz como nome do arquivo.

        touch /etc/ilogtail/users/{Alibaba Cloud Account ID} # If the /etc/ilogtail/users directory does not exist, create it manually. The user ID file requires only a filename and no file extension.

    5. Configure um grupo de máquinas. O SLS usa o grupo de máquinas para descobrir o identificador personalizado e estabelecer uma conexão heartbeat com o LoongCollector no host.

      1. No servidor, grave a string personalizada user-defined-test-1 no arquivo de identificador personalizado. Essa string será usada em uma etapa posterior.

        # Write a custom string to the specified file. If the directory does not exist, create it manually.
# The file path and name are fixed by SLS and cannot be changed.
echo "user-defined-test-1" > /etc/ilogtail/user_defined_id

      2. Faça logon no console do SLS. Na lista de projetos, clique no projeto de destino.

      3. Clique em image Resourcese, em seguida, clique em Machine Groups.

      4. À direita da Machine Groups lista, clique no image ícone e, em seguida, clique em Create Machine Group. Você também pode clicar no ícone de quatro quadrados no canto superior direito e selecionar Criar grupo de máquinas no menu suspenso.

      5. Configure as seguintes definições e clique em OK.

        • Defina o Nome do Grupo de Máquinas: o nome deve ser exclusivo no projeto. O nome deve ter de 3 a 128 caracteres. Deve começar e terminar com uma letra minúscula ou um dígito e pode conter apenas letras minúsculas, dígitos, hifens (-) e sublinhados (_).

        • Defina Machine Group Identifier: como Custom Identifier.

        • Identificador Personalizado: insira o identificador personalizado que você configurou. Esse identificador deve ser igual à string personalizada no arquivo de identificador personalizado no servidor. Neste exemplo, o identificador é user-defined-test-1.

    6. Após a criação do grupo de máquinas, clique no grupo de máquinas de destino na lista. Na seção de status do grupo de máquinas, verifique o Heartbeat status. Se o status for FAIL, aguarde cerca de dois minutos e atualize a página. Se o status do heartbeat for OK, o grupo de máquinas foi criado com êxito.

    7. Após a conclusão da instalação, crie uma configuração de coleta para coletar logs.

    Outros servidores em nuvem ou locais

    Se o seu servidor estiver hospedado em outra plataforma de nuvem ou for um servidor local, baixe manualmente o pacote de instalação. Use o método de rede pública ou aceleração de transferência no comando de instalação e configure um ID de usuário. Uma instância ECS do Alibaba Cloud também é considerada um servidor local se a instância e o projeto pertencerem a contas diferentes do Alibaba Cloud ou estiverem em regiões.

    null

    Para limites de uso do servidor, consulte Distribuições Linux suportadas.

    Procedimento

    1. Baixe o pacote de instalação. Execute o comando de download no seu servidor. No código de exemplo, substitua ${region_id} por cn-hangzhou. Para acelerar o download do pacote, consulte ID da região e substitua ${region_id} pelo ID da região da sua instância ECS.

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    2. Escolha um método de transferência e execute o comando de instalação. Substitua ${region_id} pelo ID da região da região onde o seu projeto está localizado.

      • Rede pública: este método funciona para a maioria dos cenários, incluindo transferências entre regiões e servidores em outras nuvens ou locais. No entanto, está sujeito a limites de largura de banda e possível instabilidade.

        chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-internet

      • Aceleração de transferência: use este método para transferências entre regiões, como da China continental para regiões no exterior. Ele usa a aceleração do CDN para melhorar o desempenho e evitar a alta latência e instabilidade da rede pública. Este tráfego incorre em cobranças adicionais.

        Ative o recurso de aceleração de transferência de logs entre regiões para o seu projeto antes de executar o comando de instalação.
        chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-acceleration

    3. Verifique o status de inicialização. Execute o comando. Se loongcollector is running for retornado, a inicialização foi bem-sucedida.

      sudo /etc/init.d/loongcollectord status

    4. Configure o ID de usuário. O arquivo de ID de usuário contém o ID da conta raiz do Alibaba Cloud proprietária do projeto. Esse ID verifica se a conta tem permissão para acessar e coletar logs deste servidor.

      Configure um ID de usuário apenas ao coletar logs de uma instância ECS que não esteja na sua conta, um servidor local ou um servidor de outro provedor de nuvem. Se várias contas coletarem logs do mesmo servidor, crie vários arquivos de ID de usuário nele.

      1. Faça logon no console do SLS. Passe o mouse sobre o avatar do usuário no canto superior direito. Na guia que aparece, visualize e copie o ID da conta. Certifique-se de copiar o ID da conta raiz.

      2. No servidor onde o LoongCollector está instalado, crie um arquivo de ID de usuário. Use o ID da conta raiz como nome do arquivo.

        touch /etc/ilogtail/users/{Alibaba Cloud Account ID} # If the /etc/ilogtail/users directory does not exist, create it manually. The user ID file only needs a filename and does not require a file extension.

    5. Configure um grupo de máquinas. O SLS usa o grupo de máquinas para descobrir o identificador personalizado e estabelecer uma conexão heartbeat com o LoongCollector no host.

      1. No servidor, grave a string personalizada user-defined-test-1 no arquivo de identificador personalizado. Essa string será usada em uma etapa posterior.

        # Write the custom string to the specified file. If the directory does not exist, create it manually. The file path and name are fixed by SLS and cannot be customized.
echo "user-defined-test-1" > /etc/ilogtail/user_defined_id

      2. Faça logon no console do SLS. Na lista de projetos, clique no projeto de destino.

      3. Clique em image Resourcese, em seguida, clique em Machine Groups.

      4. À direita de Machine Groups, clique em imagee, em seguida, clique em Create Machine Group.

      5. Configure as seguintes definições e clique em OK.

        • Nome do grupo de máquinas: o nome deve ser exclusivo no projeto. Deve ter de 3 a 128 caracteres, começar e terminar com uma letra minúscula ou um dígito e conter apenas letras minúsculas, dígitos, hifens (-) e sublinhados (_).

        • Machine Group Identifier: Selecione Custom Identifier.

        • Identificador personalizado: insira o identificador personalizado configurado. Ele deve corresponder à string personalizada no arquivo de identificador personalizado no servidor. Neste exemplo, o valor é user-defined-test-1.

    6. Após a criação do grupo de máquinas, clique nele na lista de grupos de máquinas. No painel de status do grupo de máquinas, verifique o Heartbeat status. Se o status for FAIL, aguarde cerca de dois minutos e atualize a página. Um status OK significa que a criação foi bem-sucedida.

    7. Após a instalação, crie uma configuração de coleta para coletar logs.

    Instalar o LoongCollector em lotes

    • O recurso de instalação automática permite selecionar várias instâncias do ECS quando as instâncias e o projeto estão na mesma conta e região.

    • Em outros cenários, use o Cloud Assistant do ECS para executar comandos como tarefas temporárias. Isso permite executar comandos de instalação do LoongCollector em lotes nas instâncias do ECS.

      Para obter os comandos de download e instalação, consulte os cenários de instalação descritos anteriormente. Para saber como usar o Cloud Assistant do ECS, consulte Criar e executar comandos.

    Atualização e reversão

    null

    O LoongCollector para de ser executado durante uma atualização e é iniciado automaticamente após a conclusão da atualização. A atualização substitui apenas os arquivos necessários. Os arquivos de configuração e os arquivos de ponto de verificação são mantidos para garantir que nenhum log seja perdido durante a atualização.

    Atualizar o LoongCollector ou atualizar o Logtail para o LoongCollector

    1. Execute o comando de download no servidor para obter o pacote de instalação mais recente. No código de exemplo, substitua ${region_id} por um ID de região, como cn-hangzhou. Para acelerar o download do pacote, consulte Regiões e substitua ${region_id} pela região onde sua instância do ECS está localizada.

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    2. Execute o comando de atualização. Use o comando upgrade para atualizar. Se você usar o comando install , ele realizará uma instalação por substituição e sua configuração original será perdida.

      chmod +x loongcollector.sh; sudo ./loongcollector.sh upgrade;

    3. Se as seguintes informações forem exibidas, a atualização foi bem-sucedida. 

      Upgrade loongcollector files successfully.
Starting loongcollector ...
Upgrade loongcollector successfully.

    Reverter o LoongCollector para o Logtail

    null

    Baixe o script logtail.sh novamente. Não use a versão anterior do script.

    1. Execute o comando de download no servidor para obter o pacote de instalação. No código de exemplo, substitua ${region_id} por um ID de região, como cn-hangzhou. Para acelerar o download do pacote, consulte Regiões e substitua ${region_id} pela região onde sua instância do ECS está localizada.

      wget https://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;

    2. Execute o comando de reversão. Para especificar uma versão, como 1.8.7, consulte a linha comentada e substitua o número da versão conforme necessário.

      chmod +x logtail.sh; sudo ./logtail.sh upgrade;
#chmod +x logtail.sh; sudo ./logtail.sh upgrade -v 1.8.7;

    Instalar uma versão específica

    Use o parâmetro -v para instalar uma versão específica. Consulte os comandos a seguir e substitua o número da versão conforme necessário.

    • LoongCollector

      chmod +x loongcollector.sh; sudo ./loongcollector.sh install ${region_id} -v 3.2.6;

    • Logtail

      chmod +x logtail.sh; sudo ./logtail.sh install ${region_id} -v 1.8.7;

    Desinstalar o LoongCollector

    1. No código de exemplo, substitua ${region_id} por um ID de região, como cn-hangzhou. Para acelerar a execução, consulte Regiões e substitua ${region_id} pela região onde sua instância do ECS está localizada.

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    2. Execute o comando de desinstalação.

      chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall;

    Perguntas frequentes

    Instalar o LoongCollector em um servidor sem conexão com a internet

    1. No servidor onde você deseja instalar o LoongCollector, execute uname -m para verificar a arquitetura do sistema. Em seguida, em um servidor com acesso à internet, execute o comando de download correspondente. Substitua ${region_id} pelo ID da região do seu projeto.

      • Arquitetura ARM:

        wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;

      • Arquitetura x86-64:

        wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;

    2. Copie o script e o pacote de instalação baixados para o servidor onde você deseja instalar o LoongCollector. Em seguida, execute o seguinte comando. Substitua ${region_id} pelo ID da região do seu projeto.

      chmod +x loongcollector.sh; ./loongcollector.sh install-local ${region_id}-internet

    3. Execute o comando de status. Se a saída for loongcollector is running, o LoongCollector foi iniciado com êxito.

      sudo /etc/init.d/loongcollectord status

    4. Como o servidor não pode acessar a internet, você também deve estabelecer uma conexão configurando um proxy.

    Atualizar o LoongCollector em um servidor sem conexão com a internet

    1. No servidor onde você deseja atualizar o LoongCollector, execute uname -m para verificar a arquitetura do sistema. Em seguida, em um servidor com acesso à internet, execute o comando correspondente. Substitua ${region_id} pela região do seu projeto.

      • Arquitetura ARM:

        wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;

      • Arquitetura x86-64:

        wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;

    2. Copie o script e o pacote de instalação para o servidor onde você deseja atualizar o LoongCollector. Em seguida, execute o seguinte comando:

      chmod +x loongcollector.sh;./loongcollector.sh upgrade-local;

    Falha na instalação com um clique

    A instalação automática é suportada apenas quando a instância do ECS e o projeto estão na mesma conta e região. Se este não for o seu caso, use um método de instalação diferente. Se sua configuração atender a esse requisito, verifique se você atendeu aos requisitos de permissão e rede. Para obter mais informações, consulte Pré-requisitos.

    Resolver um heartbeat ausente ou com falha

    Se o status do heartbeat for FAIL, pode ser porque a conexão inicial leva algum tempo. Aguarde cerca de dois minutos e atualize o status. Se o status ainda for FAIL, siga estas etapas para solucionar o problema:

    • Confirme a relação entre o servidor e o projeto do SLS. O procedimento de instalação varia de acordo com essa relação.

      • Se você usou o procedimento errado, execute o chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall; comando no servidor para desinstalar. Em seguida, repita a instalação usando o procedimento correto.

    • Se você usou o procedimento correto, mas o status do heartbeat ainda é FAIL, verifique o servidor onde o LoongCollector está instalado. Verifique se o region no arquivo /usr/local/ilogtail/ilogtail_config.json corresponde ao ID da região do seu projeto do SLS.

      • Se não corresponderem, substitua ${region_id} no comando de instalação pelo ID da região correto e execute o comando novamente. O LoongCollector atualizará o arquivo.

        Esta ação substitui a instalação existente e exclui suas configurações originais. Use este método com cautela em servidores que já estão configurados para coleta.

      • Se as informações estiverem corretas ou se o status do heartbeat ainda for FAIL após a reinstalação, prossiga para a próxima etapa.

    • Se o seu procedimento envolver um cenário de conta cruzada que exija um arquivo de ID de usuário, verifique o seguinte:

      • O ID de usuário deve ser o ID da conta raiz. Se não for, altere-o.

      • O ID da conta raiz deve pertencer à conta proprietária do projeto do SLS, e não à conta proprietária do servidor ECS.

    • Verifique o identificador personalizado configurado para o grupo de máquinas no console do SLS. Certifique-se de que ele corresponda ao conteúdo do arquivo de identificador personalizado no servidor. Se não corresponderem, modifique a configuração do console ou o arquivo para torná-los idênticos.

    • Se o status do heartbeat ainda for FAIL, verifique se você atendeu aos requisitos de rede. Para mais informações, consulte Pré-requisitos.

    Referências relacionadas

    Regiões

    1. Faça logon no console do SLS. Na lista de projetos, clique no projeto de destino.

    2. Clique no image ícone à direita do nome do projeto para acessar a página de visão geral do projeto.

    3. Na seção Informações básicas, visualize o nome da região do projeto atual. Consulte a tabela abaixo para ver o ID da região correspondente.

      Uma região representa a localização geográfica de um data center físico para recursos de nuvem. Um ID de região é o identificador exclusivo para uma região de serviço de nuvem.

    Tabela de mapeamento de região e ID da região

    Nome da região

    ID da região

    China (Qingdao)

    cn-qingdao

    China (Beijing)

    cn-beijing

    China (Zhangjiakou)

    cn-zhangjiakou

    China (Hohhot)

    cn-huhehaote

    China (Ulanqab)

    cn-wulanchabu

    China (Hangzhou)

    cn-hangzhou

    China (Shanghai)

    cn-shanghai

    China (Nanjing) - Região local - Desativação

    cn-nanjing

    China (Fuzhou) - Região local - Desativação

    cn-fuzhou

    China (Shenzhen)

    cn-shenzhen

    China (Heyuan)

    cn-heyuan

    China (Guangzhou)

    cn-guangzhou

    Filipinas (Manila)

    ap-southeast-6

    Coreia do Sul (Seul)

    ap-northeast-2

    Malásia (Kuala Lumpur)

    ap-southeast-3

    Japão (Tóquio)

    ap-northeast-1

    Tailândia (Bangkok)

    ap-southeast-7

    China (Chengdu)

    cn-chengdu

    Singapura

    ap-southeast-1

    Indonésia (Jacarta)

    ap-southeast-5

    China (Hong Kong)

    cn-hongkong

    Alemanha (Frankfurt)

    eu-central-1

    EUA (Virgínia)

    us-east-1

    EUA (Vale do Silício)

    us-west-1

    Reino Unido (Londres)

    eu-west-1

    EAU (Dubai)

    me-east-1

    Arábia Saudita (Riade)

    me-central-1

    Tipos de transferência de rede do LoongCollector

    Um endpoint é o nome de domínio de acesso para o SLS. É a URL usada para acessar um projeto e seus dados de log. O endpoint é específico para a região onde o projeto está localizado. O SLS fornece endpoints privados, endpoints públicos e endpoints de aceleração de transferência. Visualize os endpoints da seguinte forma:

    1. Faça logon no console do SLS. Na lista de projetos, clique no projeto de destino.

    2. Clique no image ícone à direita do nome do projeto para acessar a página de visão geral do projeto.

    3. Na seção Endpoints de acesso, visualize as informações de endpoint do projeto atual. Diferentes métodos de transferência de rede correspondem a diferentes endpoints. Escolher o método de transferência de rede adequado ajuda a garantir uma transmissão de dados de log mais rápida e estável.

    Tipo de rede

    Tipo de endpoint correspondente

    Descrição

    Cenários

    Rede interna do Alibaba Cloud

    Endpoint privado

    A rede interna do Alibaba Cloud é uma rede compartilhada gigabit. A transferência de dados de log pela rede interna é mais rápida e estável do que pela internet pública. A rede interna inclui VPC e a rede clássica.

    A instância ECS e o projeto do SLS estão na mesma região, ou você conectou seu servidor local à rede interna.

    null

    Crie um projeto do SLS na mesma região da sua instância ECS. Isso permite coletar logs da instância ECS pela rede interna do Alibaba Cloud sem consumir largura de banda pública.

    Internet pública

    Endpoint público

    Ao transferir dados de log pela internet pública, a velocidade e a estabilidade da coleta de dados podem ser afetadas por limites de largura de banda, oscilação de rede, latência e perda de pacotes.

    Transfira dados pela internet pública nos dois casos a seguir.

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

    • O servidor é hospedado por outro provedor de nuvem ou em seu data center local.

    Aceleração de transferência

    Endpoint de aceleração de transferência

    O uso de nós de borda do Alibaba Cloud CDN para acelerar a coleta de logs oferece vantagens significativas em latência e estabilidade de rede em comparação com a coleta pela internet pública, mas o tráfego incorre em cobranças adicionais.

    Se o seu servidor de aplicativos e o projeto do SLS estiverem em regiões chinesas e internacionais, respectivamente, a transferência de dados pela internet pública pode causar alta latência e instabilidade. Use a aceleração de transferência para transferir dados neste caso. Para mais informações, consulte Aceleração de transferência.