Simple Log Service:Gerenciar projetos

Criar um projeto

Crie um projeto para gerenciar todos os logs e fontes de log relacionadas a uma aplicação específica.

Erro ProjectAlreadyExist recebido, mas o projeto não está visível no console

• Causa: O nome de um projeto deve ser globalmente exclusivo dentro de uma região da Alibaba Cloud. Se o projeto não estiver visível na sua conta, é provável que pertença a outra conta Alibaba Cloud.

• Ação recomendada: Devido ao mecanismo de isolamento de recursos da Alibaba Cloud, não é possível visualizar ou excluir um projeto de outra conta. Utilize um nome diferente e exclusivo para o seu projeto e tente criá-lo novamente.

Identificar a origem do projeto

O SLS pode criar projetos automaticamente quando integrado a outros services da Alibaba Cloud. Caso possua muitos projetos, rastreie suas origens, compreenda os dados armazenados e revise os custos associados.

1. Faça login no console do Simple Log Service (SLS) e localize o projeto desejado na lista de projetos.

2. Verifique o ícone do service ou a coluna Description para identificar a origem do projeto:

   • Se houver um ícone antes do nome do projeto, passe o mouse sobre ele para visualizar o nome do service de cloud associado.

   • Caso a coluna Description contenha texto, ela descreve a origem do projeto.

   • Se nenhuma das condições acima for verdadeira, o projeto foi criado manualmente por um usuário.

3. Tipos de projetos criados automaticamente

   Alguns projetos são criados automaticamente pelo sistema ou por outros services da Alibaba Cloud para oferecer suporte a recursos específicos. Esses projetos geralmente seguem convenções de nomenclatura fixas e possuem finalidades dedicadas. Os tipos comuns incluem:

   • Projeto de metadados do Cloud Monitor Service (CMS): O Cloud Monitor Service (CMS) 2.0 cria automaticamente esses projetos, nomeados no formato aliyun-metadata-{user-ID}-{region-ID}, para armazenar metadados do CMS. Geralmente, esses projetos são gratuitos. Para excluir um, primeiro exclua o workspace relacionado no console do Cloud Monitor Service (CMS) 2.0.

   • Projetos criados automaticamente por outros services de cloud:

     • Application Real-Time Monitoring Service (ARMS): Cria automaticamente um projeto para armazenar dados de rastreamento.

     • ActionTrail: Cria automaticamente um projeto para armazenar logs de operação.

     • Log Audit Service: Cria projetos regionais ou centralizados para gerenciamento centralizado de logs.

5. Após identificar o service de cloud associado a um projeto, consulte Collect logs from Alibaba Cloud services para obter mais informações, como os dados armazenados no projeto.

   • Determinar se um projeto está em uso: Verifique se os services de cloud associados, como Cloud Firewall ou Web Application Firewall (WAF), ainda estão em execução. Se as informações básicas do projeto não mostrarem dados e não houver configurações do Logtail, ele pode não estar em uso ativo. No entanto, antes de excluir, confirme sempre que o service de cloud correspondente não precisa mais do SLS. Se o service associado ainda estiver em uso, não recomendamos excluir o projeto criado automaticamente por ele.

6. Para analisar o uso de recursos e o faturamento de um projeto, consulte Analyze resource usage with CloudLens for SLS.

Projeto não visível na lista de projetos: Se um projeto não aparecer na lista de projetos no console do Simple Log Service, ele pode nunca ter sido criado, ter sido excluído ou ter sido criado automaticamente por um service de cloud associado, como o Application Real-Time Monitoring Service (ARMS). Execute as etapas a seguir para solucionar o problema:

1. Na caixa de pesquisa acima da lista de projetos, insira o nome do projeto para confirmar se ele existe na sua conta Alibaba Cloud. Se a pesquisa não retornar resultados, o projeto não existe na conta Alibaba Cloud atual.

2. Verifique se o projeto está na lixeira. Na página Project Overview, escolha Basic Information > Project Recycle Bin para verificar o status da lixeira. Se a lixeira estiver ativada e o projeto estiver listado, restaure-o a partir dela.

3. Se o projeto foi criado automaticamente por um service de cloud associado, como o ARMS, acesse o console desse service e verifique se o recurso de coleta de dados está ativado. Por exemplo, no console do ARMS, escolha System Configuration > Cluster Configuration. Na página exibida, localize a opção Collection Task em ARMS Application Collection ou OpenTelemetry Application Collection, desative-a e ative-a novamente para reabilitar a coleta de dados de rastreamento. Após reativar o recurso de coleta, o projeto associado reaparecerá na lista de projetos.

   Nota

   Após desativar a opção, o servidor deixará de aceitar dados reportados por probes do lado do servidor.

Ativar proteção contra exclusão de projeto

Para projetos com dados importantes, recomendamos ativar a lixeira para evitar exclusões acidentais. Quando ativada, os projetos excluídos são movidos para a lixeira, onde ficam inativos e não permitem leitura ou gravação. Se necessário, restaure rapidamente um projeto da lixeira. A cobrança ocorre apenas pelo armazenamento de dados dos projetos na lixeira.

Nota

Por padrão, um projeto permanece na lixeira por 7 dias. Após esse período, o sistema o exclui automaticamente.

Console

Ativar o recurso de lixeira

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

2. Na página de visão geral do projeto, na seção Basic Information, localize Project recycle bin e clique em Enable caso ainda não esteja ativado.

API

Defina o parâmetro recycleBinEnabled na operação UpdateProject.

Excluir e restaurar projetos

A exclusão de um projeto pode resultar em perda de dados do LogStore, MetricStore ou EventStore associado. Antes de prosseguir, certifique-se de que os dados não são mais necessários ou que você já fez backup deles.

Nota

Você ainda será cobrado por recursos como armazenamento no dia em que excluir um Projeto. Billing stops no dia seguinte. Isso significa que você não receberá uma fatura do Simple Log Service (SLS) no terceiro dia após a exclusão do Projeto.

Console

1. Limpeza pré-exclusão

   • Sem recursos associados:

     • Ao ativar a análise de logs para vários services da Alibaba Cloud, como computação elástica, armazenamento, segurança e bancos de dados, o SLS cria automaticamente um projeto e um LogStore correspondentes no console. Se não precisar mais dos logs de um service de cloud, desative o recurso de análise de logs no console desse service. Garanta que o projeto não esteja associado a outros services da Alibaba Cloud.

   • Sem dependências de faturamento: Se o projeto estiver associado a um plano pago, como um pacote de armazenamento ou capacidade reservada, cancele a assinatura ou libere os recursos primeiro.

2. Procedimento

   • Faça backup de dados importantes (opcional)

     • Backup de dados do LogStore: Se o projeto contiver dados de log que precisam ser retidos, use o recurso Download logs do SLS para exportá-los previamente.

     • Backup de configurações: Registre configurações essenciais, como nome do projeto, capacidade de armazenamento e políticas de controle de acesso, para evitar perda de informações após a exclusão.

   • Exclua o projeto

     • Na lista de projetos, localize o projeto que deseja excluir e clique em Delete na coluna Actions.

       Troubleshoot the **ProjectDeletionNotAllowed** error

       • Sintoma: Ao tentar excluir um projeto, o sistema retorna o erro ProjectDeletionNotAllowed.

       • Causa: O projeto possui proteção contra exclusão ativada. A proteção contra exclusão é um recurso de segurança que impede a remoção acidental de um projeto. Quando ativada, não é possível excluir o projeto diretamente pelo console ou via API.

       • Solução: Desative a proteção contra exclusão antes de excluir o projeto.

         • Faça login no console do SLS e clique no projeto desejado na lista de projetos. Na página de visão geral do projeto, localize a opção de proteção contra exclusão na seção Basic Information e desative-a.

     • No painel Delete Project, insira o nome do projeto, selecione um motivo para a exclusão e clique em OK.

       Aviso

       Após a exclusão de um projeto, todos os seus dados de log e informações de configuração são removidos permanentemente e não podem ser recuperados. Confirme sua ação cuidadosamente antes de excluir um projeto para evitar perda de dados.

     • Confirme a operação: Leia o aviso e insira o nome do projeto para uma segunda confirmação.

3. Se o recurso de lixeira estiver ativado para o projeto, encontre o projeto excluído na aba Recycle Bin Projects da lista de projetos. Por padrão, um projeto permanece na lixeira por 7 dias, período durante o qual é possível restaurá-lo ou excluí-lo permanentemente.

4. Confirmar o status da exclusão

   • A exclusão é uma operação assíncrona. Após enviar uma solicitação de exclusão, o sistema limpa gradualmente o projeto em segundo plano. Se tentar excluir o mesmo projeto novamente e receber uma mensagem de "Projeto não existe", isso geralmente indica que o projeto foi excluído com sucesso.

   • Acesse o console do SLS e verifique se o projeto alvo desapareceu da lista de projetos. Se a lista estiver vazia, todos os recursos do projeto naquela região foram limpos.

   • Caso tenha ativado a lixeira, verifique também a lista Recycle Bin Projects para confirmar se o projeto foi excluído permanentemente ou restaurado.

API

DeleteProject.

A exclusão de um projeto SLS afeta chamadas de API do Alibaba Cloud Model Studio ou alertas de monitoramento em outras regiões?

A exclusão de um projeto SLS não afeta as chamadas de API do Alibaba Cloud Model Studio ou os services de inferência. Os dois produtos são independentes e não possuem dependência direta. A exclusão remove apenas os dados de log e a configuração no projeto excluído.

Excluir um projeto em uma região, como Ulanqab, não afeta o monitoramento ou alertas de services de cloud em outra região, como Zhangjiakou. Os projetos do SLS são estritamente isolados por região.

Gerenciar cotas de recursos

Se suas cotas de recursos forem insuficientes, ajuste várias métricas de cota para o seu projeto conforme suas necessidades, incluindo o número máximo de LogStores, shards, configurações do Logtail e grupos de máquinas.

É possível criar no máximo 150 projetos em uma conta Alibaba Cloud. Se precisar de um limite maior, abra um ticket .

Console

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

2. Na página de visão geral do projeto, vá para a seção Basic Information, localize Resource quotas e clique em Manage. No painel Resource Quotas, ajuste a cota para o recurso alvo e clique em Save para enviar sua solicitação. A alteração leva cerca de uma hora para entrar em vigor.

Supported quota metrics

Quota metric	Description	Default	Adjustable limit
Maximum LogStores	Número máximo de LogStores que podem ser criados em um projeto.	200	400
Maximum shards	Quantidade máxima de shards permitida em um projeto.	400	800
Maximum Logtail configurations	Limite de configurações do Logtail por projeto.	200	400
Maximum machine groups	Total máximo de grupos de máquinas em um projeto.	200	400
Maximum dashboards	Número máximo de painéis que podem ser criados em um projeto.	100	400
Maximum charts per dashboard	Quantidade máxima de gráficos que um painel pode conter.	200	400
Maximum saved searches	Limite de pesquisas salvas por projeto.	100	400
Maximum export tasks	Número máximo de tarefas de exportação permitidas em um projeto.	100	400
Maximum import tasks	Quantidade máxima de tarefas de importação em um projeto.	100	400
Maximum scheduled SQL jobs	Limite de jobs SQL agendados por projeto.	100	400
Maximum transformation jobs	Número máximo de jobs de transformação permitidos em um projeto.	100	400
Maximum alerts	Quantidade máxima de alertas que podem ser criados em um projeto.	100	400
Maximum subscription tasks	Limite de tarefas de assinatura por projeto.	100	400
Maximum write traffic per project (GB/min)	Tráfego total de gravação de todos os LogStores em um projeto dentro de um minuto.	100	200
Maximum writes per project (10.000/min)	Número total de operações de gravação em todos os LogStores de um projeto dentro de um minuto.	60	200
Maximum reads per project (10.000/min)	Total de operações de leitura em todos os LogStores de um projeto dentro de um minuto.	60	200

Acelerar transferência de logs entre regiões

Para transferências de logs de longa distância, como gravar logs de uma região fora da China continental para uma dentro, ative o recurso de aceleração de transferência. Esse recurso utiliza uma rede global de data centers para rotear solicitações de usuários ao ponto de acesso mais próximo por meio de roteamento inteligente. Ele melhora significativamente a velocidade de acesso com uma rede e protocolos otimizados. A aceleração de transferência é cobrada com base na quantidade de dados transferidos.

Console

Ativar aceleração de transferência

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

2. Na página de visão geral do projeto, vá para a seção Endpoints, localize Acceleration endpoint e clique em Enable. Leia a mensagem na caixa de diálogo e clique em Modify.

3. Após ativar a aceleração de transferência, a velocidade de transferência é melhorada ao usar o Logtail para coleta de logs e ao executar jobs de transformação de dados.

API

1. Primeiro, chame a operação PutProjectTransferAcceleration.

2. Para usar o recurso de aceleração, defina o endpoint como o endpoint de aceleração. Os endpoints de aceleração suportam acesso via API apenas por HTTP e HTTPS, e não suportam protocolos como Kafka ou gRPC. Em cenários onde a aceleração de transferência não é necessária, recomendamos usar um service endpoint padrão para reduzir custos de transferência.

       /**
            * This example gets the AccessKey ID and AccessKey secret from environment variables.
            */String accessId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
           String accessKey = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
           /**
            * The service endpoint for Simple Log Service. Use an acceleration endpoint.
            */String endpoint = "log-global.aliyuncs.com";
           /**
            * Create a Simple Log Service client.
            */static Client client = new Client(host, accessId, accessKey);

Nota

Instruções de verificação de acesso ao domínio acelerado

Ao verificar manualmente a alcançabilidade de rede do domínio acelerado, use o formato completo do domínio: <projectname>.log-global.aliyuncs.com. Substitua <projectname> pelo nome real do seu Projeto.

Observe que tanto o agente LoongCollector quanto o SDK do SLS adicionam automaticamente o nome do Projeto ao iniciar solicitações. Portanto, não é necessário adicionar manualmente o prefixo <projectname> no arquivo de configuração.

Agrupar recursos

Quando precisar agrupar projetos, utilize tags ou grupos de recursos para categorizá-los. Use tags para gerenciamento no nível do projeto e grupos de recursos para gerenciamento no nível da conta Alibaba Cloud.

Definir grupo de recursos

Um projeto pode pertencer a apenas um grupo de recursos.

Console

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

2. Na página de visão geral do projeto, na seção Resource group details, passe o mouse sobre o Resource group ID, clique em Modify e selecione um grupo de recursos.

API

ChangeResourceGroup.

Definir tags

Console

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

2. Na página de visão geral do projeto, na seção Tags, clique em Edit e defina as tags no painel Edit tag.

API

TagResources.

Visualizar endpoints e definir um domínio personalizado

Visualize informações de endpoint ou substitua um endpoint público por um domínio personalizado. Após concluir a configuração, use o domínio correspondente como endpoint nas chamadas de API.

Console

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

2. Na página de visão geral do projeto, vá para a seção Endpoints para visualizar as informações de endpoint do projeto atual.

3. Na página de visão geral do projeto, na seção Basic Information, passe o mouse sobre Custom domain e clique em Set. No painel Specify Custom Endpoint, configure o nome de domínio e clique em Bind.

4. No console do Alibaba Cloud DNS, adicione um registro CNAME para ativar a vinculação do domínio. Defina o Record Value como o Public Endpoint listado na seção Endpoints da página de visão geral do projeto. Para instruções detalhadas, consulte CNAME record.

API

CreateDomain.

Vincular um certificado SSL a um domínio personalizado

• Comportamento atual: O console do SLS não oferece suporte para upload ou vinculação direta de certificados SSL a um domínio personalizado.

• Soluções:

  • Opção 1 (Recomendada): Usar Alibaba Cloud CDN. Utilize o Alibaba Cloud CDN para acelerar o endpoint do SLS, vincule um certificado SSL no console do CDN e acesse o SLS através do CDN.

  • Opção 2 (Padrão): Usar o endpoint padrão do SLS. O endpoint padrão integrado do SLS suporta HTTPS com um certificado SSL embutido. Na maioria dos casos, é possível usá-lo sem configuração adicional.

Monitorar e manter projetos

Utilize o recurso de logs de service para obter logs de operação de recursos (criar, modificar, atualizar, excluir) e logs de execução de tarefas (SQL agendado, importação de dados, envio de dados) dentro de um projeto. Também é possível obter logs de latência de consumo de grupos de consumidores de um LogStore, além de logs de erro, heartbeat e estatísticas do Logtail.

Console

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

2. Na página Service log do projeto, clique em Enable Detailed Logs. No painel Modify service log settings, selecione os logs de service que deseja ativar e o projeto onde serão armazenados.

   • Logs detalhados: Fornece logs completos de operação. Este é um recurso de pagamento conforme o uso.

   • Logs importantes: Fornece logs de medição, logs de latência de grupo de consumidores e logs de heartbeat do Logtail. Este recurso é gratuito.

   • Logs operacionais de tarefas: Fornece os logs operacionais de tarefas de importação de dados, jobs SQL agendados e tarefas de envio. Este recurso é gratuito.

   • Local de armazenamento de logs: Escolha um projeto existente ou permita que o sistema crie automaticamente um novo para armazenar esses logs.

Limites e compatibilidade

• Limite de exclusão em massa: Atualmente, o SLS não fornece uma ferramenta para exclusão em massa de projetos ou LogStores. É necessário excluí-los um a um manualmente.

• Acesso móvel: Acesse o console do SLS através de um navegador móvel para fazer login e gerenciar projetos, incluindo criação, modificação e exclusão.

Mais informações

Para armazenar diferentes tipos de dados em um projeto, crie diferentes tipos de stores. Para mais informações, consulte Manage stores.