Simple Log Service:Instalar, executar, atualizar e desinstalar o Logtail

Instalação com um clique

O Simple Log Service permite instalar o Logtail em uma instância ECS com apenas um clique. A instalação utiliza a capacidade de orquestração do CloudOps Orchestration Service (OOS), eliminando a necessidade de fazer logon na instância ECS para executar as etapas manualmente. Se você fizer logon com uma conta Alibaba Cloud, terá todas as permissões necessárias por padrão e poderá realizar as operações diretamente.

Caso faça logon como usuário RAM, solicite ao proprietário da conta Alibaba Cloud que conceda permissões para gerenciar recursos do OOS. O proprietário da conta pode usar uma política do sistema ou uma política personalizada para criar um usuário RAM e conceder permissões a ele:

• Políticas do sistema:

  • AliyunOOSFullAccess: concede permissões totais para gerenciar o CloudOps Orchestration Service (OOS).

  • AliyunECSFullAccess: concede permissões para gerenciar o ECS.

• Políticas personalizadas: Se você tiver requisitos rigorosos de segurança de dados, poderá criar uma política personalizada para autorização refinada. A política a seguir concede permissões para gerenciar recursos do OOS:

ilogtail is running

Para instalar o Logtail em uma instância ECS e, simultaneamente, criar e configurar um grupo de máquinas, siga estas etapas:

1. Faça logon no console do Simple Log Service. Clique no projeto que gerencia seus recursos de log para visualizar a lista de LogStores. Clique no ícone antes do nome do LogStore que armazena os logs para expandi-lo. Em seguida, clique no ícone exibido após Data Collection, selecione um modelo de log de texto na caixa de diálogo e clique em Integrate Now.

   O Simple Log Service fornece vários modelos de log de texto, incluindo expressões regulares, linha única e linhas múltiplas. A diferença entre eles reside apenas nos plug-ins de análise de logs; todas as outras configurações são idênticas. Também é possível adicionar ou remover plug-ins de análise em um modelo. Selecione um modelo com base nas características dos logs que deseja coletar ou escolha qualquer modelo de log de texto e configure os plug-ins posteriormente conforme necessário.

2. Na página Machine Group Configurations, selecione Servers e ECS como ambiente de instalação e clique em Create Machine Group.

3. No painel Create Machine Group, selecione uma ou mais instâncias ECS localizadas na mesma região do projeto. Clique em Install and Create Machine Group, aguarde a conclusão da instalação, especifique o Name do grupo de máquinas e clique em OK.

   Se a instalação falhar ou permanecer no estado de espera, verifique se as instâncias ECS estão na mesma região do projeto.

4. Após a instalação, acesse a página Resources > Machine Groups. Clique no grupo de máquinas criado e verifique o status de Heartbeat na seção Machine Group Configurations > Machine Group Status. Um status de heartbeat OK indica que o grupo de máquinas foi criado com sucesso.

Instalação manual

Escolha o método de download e instalação do Logtail compatível com o sistema operacional e a arquitetura de CPU do seu servidor.

Nos exemplos de código, ${region_id} representa a região onde o projeto do Simple Log Service está localizado. Substitua esse valor pelo ID real da região consultando Regiões suportadas. Por exemplo, o ${region_id} para China (Hangzhou) é cn-hangzhou.

Antes de instalar o Logtail, observe os seguintes pontos:

• Compatibilidade do Logtail 2.0: Caso sua máquina tenha especificações baixas ou execute um sistema operacional mais antigo, o Logtail 2.0 pode apresentar problemas de compatibilidade que impedem o funcionamento correto do software. Nessa situação, recomendamos baixar a versão 1.8.7 em https://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/1.8.7/logtail.sh e executar o comando ./logtail.sh install ${region_id} -v 1.8.7 para instalá-la.

Linux

• As seguintes versões de servidores Linux x86-64 (64 bits) são suportadas: - Alibaba Cloud Linux 2 e 3

  • Anolis OS 7 e 8 - CentOS Linux 6, 7 e 8 - Debian GNU/Linux 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,0 - Outros sistemas operacionais Linux baseados em glibc 2,5 ou posterior. O Logtail 2.0 ou superior requer glibc 2,6 ou posterior.

  • A CPU deve suportar os conjuntos de instruções sse4_2 e avx para o Logtail 2.0 ou superior. - As seguintes versões de servidores Linux ARM (64 bits) são suportadas: - 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 mínima de CPU exigida é ARMv8.2-A para o Logtail 2.0 ou superior.

Servidores com acesso à internet (ARM e x86-64)

Para servidores com acesso à internet, baixe o Logtail diretamente:

ilogtail is running

Selecione um comando de instalação conforme suas condições de rede:

ilogtail is running

Servidores ARM offline

Para servidores offline, primeiro baixe o script de instalação e o pacote de instalação em um servidor com acesso à internet:

ilogtail is running

Copie o script e o pacote de instalação para o servidor onde deseja instalar o Logtail e selecione um comando de instalação conforme suas condições de rede:

ilogtail is running

Servidores x86-64 offline

Em servidores offline, baixe inicialmente o script e o pacote de instalação em uma máquina com acesso à internet:

ilogtail is running

Transfira o script e o pacote de instalação para o servidor alvo e escolha o comando apropriado de acordo com suas condições de rede:

ilogtail is running

Windows

Versões do Windows suportadas: - Microsoft Windows Server 2008, 2012, 2016, 2019, 2022 e 2025 - Microsoft Windows 7 - Microsoft Windows 10 - Microsoft Windows Server Version 1909 - Microsoft Windows Server Version 2004

Baixe o pacote de instalação correspondente à arquitetura do seu servidor e à região do seu projeto:

Extraia o pacote de instalação, execute o Windows PowerShell como administrador e navegue até o diretório logtail_installer, que corresponde ao local onde o pacote foi extraído. Escolha o comando de instalação adequado às suas condições de rede

:

ilogtail is running

ilogtail is running

wget http://logtail-release-cn-north-2-gov-1.oss-cn-north-2-gov-1.aliyuncs.com/linux64/logtail.sh -O logtail.sh;chmod +x logtail.sh; ./logtail.sh install cn-north-2-gov-1

Linux

Iniciar o Logtail

ilogtail is running

Parar o Logtail

ilogtail is running

Windows

1. Faça logon no servidor de destino.

2. Acesse Start > Control Panel > Tools > Service.

3. Na caixa de diálogo Service, localize o serviço desejado.

   • Para a versão 0.x.x.x, selecione o serviço LogtailWorker.

   • Para a versão 1.0.0.0 ou superior, selecione o serviço LogtailDaemon.

4. Clique com o botão direito no serviço e escolha a operação necessária, como Start, Stop ou Restart.

Linux

Verificar o status do Logtail no Linux

Execute o comando sudo /etc/init.d/ilogtaild status para checar o status do Logtail. Se o sistema retornar ilogtail is running, o Logtail está instalado. Caso não esteja em execução, desinstale-o e reinstale-o.

Verificar a versão do Logtail no Linux

O Logtail armazena suas informações de versão no campo logtail_version do arquivo /usr/local/ilogtail/app_info.json. Execute o comando abaixo para visualizar essas informações.

ilogtail is running

O resultado retornado será semelhante a este:

ilogtail is running

Windows

Verificar o status do Logtail no Windows

Verifique o status do Logtail para confirmar se ele está instalado no servidor de destino.

1. Abra a janela Executar, digite services.msc e abra a janela Serviços.

2. Verifique o status de execução do serviço LogtailDaemon (para Logtail 1.0.0.0 ou superior) ou do serviço LogtailWorker (para Logtail 0.x.x.x).

   O status Running indica que o Logtail está instalado.

Verificar a versão do Logtail no Windows

É possível consultar a versão do Logtail no campo logtail_version do arquivo app_info.json, localizado no caminho de instalação.

Por exemplo, o conteúdo abaixo indica que a versão do Logtail é 1.0.0.0.

ilogtail is running

Linux

Antes de atualizar o Logtail em um servidor Linux, considere os seguintes pontos:

• Comando de atualização: Para atualizar o Logtail, utilize o comando upgrade. O uso do comando install resulta em uma instalação por sobrescrita, causando a perda das configurações originais.

• Interrupção do serviço: Durante a atualização, o Logtail para brevemente. Após a conclusão, ele reinicia automaticamente e é registrado como item de inicialização. A atualização sobrescreve apenas os arquivos necessários, preservando arquivos de configuração e checkpoints, o que garante que nenhum log seja perdido.

  Nos exemplos de código, ${region_id} refere-se à região do projeto Simple Log Service. Substitua pelo ID real da região conforme descrito em Regiões suportadas. Por exemplo, o ${region_id} para China (Hangzhou) é cn-hangzhou.

Selecione o método de atualização do Logtail na tabela a seguir:

A mensagem abaixo confirma que a atualização foi bem-sucedida.

ilogtail is running

Windows

O procedimento de atualização segue os mesmos passos da instalação. Baixe e extraia o pacote de instalação mais recente e realize as etapas de instalação.

Linux

Obtenha o ${region_id} da região onde seu projeto do Simple Log Service está localizado. Substitua ${region_id} e execute o comando abaixo para desinstalar o Logtail.

Para consultar o ${region_id} de cada região, veja Regiões suportadas. Por exemplo, o ${region_id} para China (Hangzhou) é cn-hangzhou.

ilogtail is running

Windows

Execute o Windows PowerShell ou cmd como administrador, navegue até o diretório logtail_installer (local onde o pacote de instalação foi extraído) e execute o seguinte comando.

ilogtail is running

Após a desinstalação, o diretório de instalação do Logtail é removido, mas algumas configurações permanecem no diretório C:\LogtailData. Você pode excluí-las manualmente conforme necessário. As informações retidas incluem:

• checkpoint: armazena as informações de checkpoint de todos os plug-ins do Logtail. Este arquivo existe apenas se você utilizar plug-ins do Logtail.

• user_config.d: diretório que contém as configurações locais de coleta. Arquivos com extensão .json são tratados como configurações de coleta. O formato é semelhante a /usr/local/ilogtail/user_log_config.json.

• logtail_check_point: guarda as informações de checkpoint do componente principal do Logtail.

• users: contém os arquivos de identificador de usuário configurados.

Clusters ACK

Esta operação aplica-se exclusivamente a clusters Kubernetes dedicados e clusters Kubernetes gerenciados.

Instalar o componente Logtail em um cluster ACK existente

1. Faça logon no Container Service Management Console

2. Na página Clusters, escolha More > Operations > Add-ons na coluna mais à direita do cluster de destino.

3. Na aba Logs and Monitoring, localize logtail-ds e clique em Install.

   Após a conclusão da instalação, o Simple Log Service cria automaticamente um projeto chamado k8s-log-${your_k8s_cluster_id}.

Instalar o componente Logtail durante a criação de um cluster ACK

1. Faça logon no Container Service Management Console

2. No painel de navegação à esquerda, clique em Clusters.

3. Na página Clusters, clique em Create Cluster.

4. Na etapa de configuração Component Configurations, selecione Enable Log Service.

Ao selecionar Enable Log Service, uma mensagem solicitando a criação de um projeto será exibida. Para entender melhor como o Simple Log Service organiza os logs, consulte Projeto. É possível criar um projeto das duas maneiras seguintes:

• Select Project: Selecione um projeto existente para gerenciar os logs de contêineres coletados.

• Create Project: O Simple Log Service cria automaticamente um projeto para gerenciar os logs de contêineres coletados. O ClusterID é o identificador exclusivo do cluster Kubernetes que você está criando.

  Na seção Log Service, selecione Enable Log Service. Após selecionar Create a new project, o sistema cria automaticamente um projeto chamado k8s-log-{ClusterID}.

Após a conclusão da instalação, os seguintes recursos do Simple Log Service são criados automaticamente no projeto selecionado.

Clusters autogerenciados

1. Faça logon no seu cluster Kubernetes e escolha um comando conforme a região para baixar o Logtail e seus componentes dependentes.

   ilogtail is running

2. Modifique o arquivo de configuração ./alibaba-cloud-log-all/values.yaml.

   O arquivo de configuração contém os seguintes parâmetros:

   ilogtail is running

   Parâmetro	Descrição
   SlsProjectName	Nome do projeto para o qual o Logtail envia os logs.
   Region	ID da região onde o projeto está localizado. Por exemplo, o ID da região China (Hangzhou) é cn-hangzhou.
   AliUid	ID da conta Alibaba Cloud proprietária do projeto. O ID deve estar entre aspas duplas (""), por exemplo: AliUid: "11**99".
   AccessKeyID	AccessKey ID da conta Alibaba Cloud proprietária do projeto. Recomendamos utilizar o par de AccessKeys de um usuário RAM e conceder a permissão AliyunLogFullAccess a esse usuário.
   AccessKeySercret	AccessKey secret da conta Alibaba Cloud proprietária do projeto. Recomendamos utilizar o par de AccessKeys de um usuário RAM e conceder a permissão AliyunLogFullAccess a esse usuário.
   ClusterID	ID personalizado do cluster. Aceita apenas letras, dígitos e hifens (-). Este parâmetro corresponde a ${your_k8s_cluster_id} nas operações subsequentes. Não configure o mesmo ID de cluster para clusters Kubernetes diferentes.
   SlsMonitoring	Define se a coleta de dados de métricas do cluster deve ser ativada. Valores válidos: true (padrão) para ativar a coleta, e false para desativá-la.
   Net	Tipo de rede que o Logtail utiliza para transferir dados. Se o cluster não estiver conectado à rede interna da Alibaba Cloud, utilize a internet. Valores válidos: Internet (padrão) para internet pública, e Intranet para rede interna.
   SLS_CONTAINERD_USED	Indica se o runtime de contêineres é containerd. Valores válidos: true indica que o runtime é containerd, e false (padrão) indica que não é. Em clusters Kubernetes autogerenciados que utilizam containerd, os logs podem não ser coletados pelo Logtail caso este parâmetro não esteja ativado.

3. Instale o Logtail e seus componentes dependentes.

   Execute o comando echo "$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)" para consultar a OS-architecture do seu host. O script k8s-custom-install.sh suporta as seguintes combinações de OS-architecture: linux-386, linux-amd64, linux-arm, linux-arm64, linux-ppc64le, linux-s390x e darwin-amd64.

   ilogtail is running

   Arquivo values.yaml que você modificou.

Clusters ACK

Geralmente, recomendamos o uso do método de atualização automática. No entanto, se você modificou parâmetros como variáveis de ambiente no DaemonSet do logtail-ds ou no Deployment do alibaba-log-controller, utilize o método de atualização manual para evitar que suas alterações sejam revertidas.

Atualização automática

1. Faça logon no Container Service Management Console.

2. Na aba Logs and Monitoring, localize logtail-ds e clique em Upgrade.

3. Na caixa de diálogo Update, clique em OK.

Após realizar a atualização, verifique o status dos pods logtail-ds no console de gerenciamento do Container Service. Se todos os pods logtail-ds estiverem no estado Running, a atualização foi bem-sucedida.

Atualização manual

Uma atualização manual abrange o logtail-ds e o alibaba-log-controller. Na maioria dos casos, basta atualizar o logtail-ds para obter as capacidades de coleta da nova versão do Logtail. Para acessar as funcionalidades fornecidas pelo novo CRD do Logtail, é necessário atualizar também o alibaba-log-controller. Os passos a seguir tomam o logtail-ds como exemplo.

1. Faça logon no Container Service Management Console

2. Navegue até Workloads > DaemonSets.

   Nota

   Para atualizar o alibaba-log-controller, acesse Workloads > Deployments. Em seguida, localize o alibaba-log-controller no namespace kube-system e conclua a atualização.

3. Defina o Namespace como kube-system e clique em Edit referente ao logtail-ds.

4. Verifique a existência das variáveis de ambiente listadas abaixo.

   Se as variáveis ALIYUN_LOGTAIL_CONFIG, ALIYUN_LOGTAIL_USER_ID e ALIYUN_LOGTAIL_USER_DEFINED_ID não estiverem presentes, sua versão do Logtail pode ser muito antiga. Nesse caso, atualize o Logtail.

5. Em Image Version, clique em Select Image Version.

6. Na caixa de diálogo Image Version, selecione a versão mais recente e clique em OK.

7. No lado direito da página, clique em Update.

   Após realizar a atualização, verifique o status dos pods logtail-ds no console de gerenciamento do Container Service. Se todos os pods logtail-ds estiverem no estado Running, a atualização foi bem-sucedida.

Clusters autogerenciados

Recomendamos realizar a atualização instalando o componente Logtail mais recente. Atualizar apenas o número da versão da imagem de alguns componentes, como logtail-ds ou alibaba-log-controller, pode causar falha na atualização.

Para concluir a atualização automática, reinstale o componente Logtail.

Clusters ACK

1. Faça logon no Container Service Management Console

2. Na aba Logs and Monitoring, localize logtail-ds e clique em Uninstall.

3. Siga as instruções na tela, clicando em OK para concluir a desinstalação.

Clusters autogerenciados

Execute o comando kubectl delete -R -f result para desinstalar componentes instalados, como logtail-ds e alibaba-log-controller.

Este comando exclui recursivamente todos os recursos no diretório result. Utilize-o com cautela caso o diretório contenha outros recursos.