Todos os produtos
Search
Central de documentação

Simple Log Service:Gerenciar projetos

Última atualização: Jun 23, 2026

Um projeto é a unidade fundamental de gerenciamento de recursos no Simple Log Service (SLS), utilizado para isolamento de recursos e controle de acesso.

Contexto

Um projeto pode conter recursos como Logstores, Metricstores e grupos de máquinas, e serve como ponto de entrada para acessar os recursos do SLS. Use projetos diferentes para gerenciar dados de diferentes aplicações, produtos ou ambientes pelos seguintes motivos:

  • Organizar e gerenciar diferentes Logstores ou Metricstores: Use projetos para classificar e gerenciar logs de diferentes aplicações, produtos ou ambientes. Isso simplifica as tarefas de consumo, exportação e análise de dados.

  • Isolar o controle de acesso: Conceda a usuários Resource Access Management (RAM) permissões para executar operações em projetos específicos.

  • Endpoints específicos do projeto: Cada projeto possui um endpoint exclusivo, que serve como ponto de entrada de rede para gravação, leitura e gerenciamento de seus recursos. Para mais informações sobre endpoints, consulte Endpoints de serviço.

Permissões (expansível)

  • Se você fizer login com uma conta Alibaba Cloud, terá permissões completas por padrão e poderá executar todas as operações em projetos.

  • Se você fizer login como usuário Resource Access Management (RAM), será necessário obter as duas políticas de sistema a seguir para o SLS a partir da conta Alibaba Cloud.

    • AliyunLogFullAccess: Concede permissões completas para gerenciar o SLS.

    • AliyunLogReadOnlyAccess: Concede permissões somente leitura para o SLS.

    Se as políticas de sistema não atenderem às suas necessidades, crie políticas personalizadas para implementar o gerenciamento detalhado de permissões. Para mais informações, consulte Criar uma política personalizada.

    Operação

    Permissões necessárias

    Criar um projeto

    • log:ListProject

    • log:CreateProject

    Excluir um projeto

    • log:ListProject

    • log:GetProject

    • log:DeleteProject

    Executar operações em um projeto na lixeira

    • log:ListProjectsInRecycleBin

    • log:CreateProject

    • log:DeleteProject

    • log:UpdateProject

    Visualizar um projeto específico

    • log:ListProject

    • log:GetProject

    • log:ListLogStores

    • log:ListSavedSearch

    • log:ListDashboard

    • log:ListDomains

    • log:GetSqlInstance

    • log:ListTagResources

    Gerenciar cotas de recursos

    As permissões necessárias são as mesmas da visualização de um projeto específico.

    Configurar aceleração de transferência

    • log:ListProject

    • log:GetProject

    • log:ListLogStores

    • log:ListSavedSearch

    • log:ListDashboard

    • log:ListDomains

    • log:GetSqlInstance

    • log:ListTagResources

    • log:PutProjectTransferAcceleration

    Configurar um grupo de recursos

    • log:ListProject

    • log:GetProject

    • log:ListLogStores

    • log:ListSavedSearch

    • log:ListDashboard

    • log:ListDomains

    • log:GetSqlInstance

    • log:ListTagResources

    • log:ChangeResourceGroup

    Configurar tags

    • log:ListProject

    • log:GetProject

    • log:ListLogStores

    • log:ListSavedSearch

    • log:ListDashboard

    • log:ListDomains

    • log:GetSqlInstance

    • log:ListTagResources

    • log:TagResources

    • log:UntagResources

    Configurar um nome de domínio personalizado

    • log:ListProject

    • log:GetProject

    • log:ListLogStores

    • log:ListSavedSearch

    • log:ListDashboard

    • log:ListDomains

    • log:GetSqlInstance

    • log:ListTagResources

    • log:CreateDomain

    Monitorar recursos do projeto

    • log:ListProject

    • log:GetProject

    • log:ListLogStores

    • log:ListSavedSearch

    • log:ListDashboard

    • log:ListDomains

    • log:GetSqlInstance

    • log:ListTagResources

    • log:GetLogging

    • log:CreateLogStore

    • log:CreateIndex

    • log:UpdateIndex

    • log:CreateDashboard

    • log:UpdateDashboard

    • log:GetLogStore

    • log:UpdateLogStore

    • log:UpdateLogging

    • log:GetLogStoreLogs

Todos os parâmetros do projeto (expansível)

Parâmetro

Descrição

Região

Selecione uma região Alibaba Cloud com base na origem dos seus logs e outros fatores. Após a criação de um projeto, sua região não pode ser alterada. O SLS não oferece suporte à migração de projetos entre regiões. Se você deseja coletar logs de instâncias ECS, selecione a mesma região das instâncias ECS. Isso permite coletar logs pela rede interna da Alibaba Cloud e acelerar a coleta de logs.

Nome do projeto

O nome do projeto deve ser globalmente exclusivo dentro de uma região Alibaba Cloud. O nome não pode ser alterado após a criação do projeto.

Lixeira do projeto

Ative o recurso de lixeira para projetos que contêm dados importantes, a fim de evitar exclusões acidentais. Quando esse recurso está ativado, os projetos excluídos são movidos para a lixeira. Os projetos na lixeira ficam inativos e não suportam operações de leitura ou gravação. Se você descobrir que um projeto ainda é necessário após ser movido para a lixeira, restaure-o rapidamente. Você será cobrado apenas pelo armazenamento de dados dos projetos na lixeira.

Comentário do projeto

Um comentário para o projeto. O comentário pode conter até 64 caracteres. Não é permitido usar colchetes angulares (<>), apóstrofos ('), barras invertidas (\) ou aspas duplas (").

Grupo de recursos

  • Um grupo de recursos é um contêiner que permite gerenciar um grupo de recursos relacionados em uma única conta Alibaba Cloud.

  • Um recurso pode pertencer a apenas um grupo de recursos.

  • Mapeie grupos de recursos para conceitos como projetos, aplicações ou organizações conforme necessário.

Ativar logs

A ativação dos logs de serviço cria um Logstore e um painel correspondentes no local de armazenamento selecionado. O Logstore para logs de operação é cobrado como um Logstore padrão. Os Logstores para outros logs são gratuitos.

  • Logs detalhados: Logs de operação completos, cobrados com base no modelo de pagamento conforme o uso.

  • Logs importantes: Logs de medição, logs de latência de grupo de consumidores e logs de heartbeat do Logtail. Gratuitos.

  • Logs de execução de tarefas: Logs de execução de importação de dados, SQL agendado e tarefas de envio de dados. Gratuitos.

Local de armazenamento de logs

Um projeto chamado log-service-{user-ID}-{region} é criado automaticamente. Recomendamos salvar todos os logs da mesma região neste projeto.

Criar um projeto

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

Console

  1. Faça login no console do Simple Log Service, navegue até a seção de projetos e clique em Create Project.

  2. Configure o projeto.

    1. Região: Selecione uma região Alibaba Cloud com base na localização das suas fontes de log e outros fatores. Após a criação de um projeto, sua região não pode ser alterada. O SLS não oferece suporte à migração de projetos entre regiões. Se você deseja coletar logs de instâncias ECS, selecione a mesma região das instâncias ECS. Isso permite coletar logs pela rede interna da Alibaba Cloud e acelerar a coleta de logs.

    2. Nome do projeto: O nome do projeto. O nome deve ser globalmente exclusivo dentro da Alibaba Cloud. Após a criação de um projeto, seu nome não pode ser alterado.

    3. Mantenha os outros parâmetros com seus valores padrão.

API

CreateProject.

Identificar a origem do projeto

O SLS pode criar um projeto automaticamente quando é associado a outros serviços de nuvem. Se você possui muitos projetos, é possível rastrear suas origens para encontrar informações como procedência, dados armazenados e custos.

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

  2. Verifique se há um ícone ao lado do nome do projeto ou consulte a coluna Descrição para identificar a origem do projeto:

    • Se um ícone aparecer antes do nome do projeto, passe o cursor sobre ele. O nome do serviço de nuvem associado será exibido.

    • Se a coluna Description contiver informações, ela descreve a origem do projeto.

    • Se nenhuma dessas condições for atendida, o projeto foi criado manualmente.

  3. Após identificar o serviço de nuvem associado ao projeto, consulte Coleta de logs para serviços Alibaba Cloud para mais informações, como os dados armazenados.

    Se o serviço de nuvem associado ainda estiver em uso, não exclua o projeto criado automaticamente.
  4. Para analisar e estimar o uso de recursos e o faturamento de um projeto, consulte Analisar o uso de recursos com o CloudLens for SLS.

Ativar a proteção contra exclusão de projetos

Ative o recurso de lixeira para projetos que contêm dados importantes, a fim de evitar exclusões acidentais. Quando esse recurso está ativado, os projetos excluídos são movidos para a lixeira. Os projetos na lixeira ficam inativos e não suportam operações de leitura ou gravação. Se você decidir posteriormente que um projeto excluído ainda é necessário, restaure-o rapidamente a partir da lixeira. Você será cobrado apenas pelo armazenamento de dados dos projetos na lixeira.

null

Um projeto é mantido na lixeira por 7 dias por padrão e é excluído automaticamente após o término do período de retenção.

Console

Ativar o recurso de lixeira

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

  2. Na seção Basic Information da página Project Overview, ative Recycle Bin.

API

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

Excluir e restaurar recursos de projetos

Ao excluir um projeto, os dados em seus Logstores são permanentemente excluídos. Antes de excluir um projeto, verifique se os dados em recursos como Logstores, Metricstores e Eventstores não são mais necessários ou se já foram copiados em backup.

null

Você será cobrado pelo armazenamento e outros recursos no dia em que excluir o projeto. Para mais informações sobre como interromper a cobrança, consulte Como desativar o SLS e interromper a cobrança?. A cobrança do SLS é interrompida no terceiro dia após a exclusão do projeto.

Console

  1. Limpar recursos antes da exclusão

    • Sem vínculos de serviço:

      • Quando você ativa o recurso de análise de logs para serviços Alibaba Cloud, como computação elástica, armazenamento, segurança e bancos de dados, um projeto e um Logstore correspondentes são criados automaticamente no console do SLS. Se você não precisar mais dos logs de um serviço Alibaba Cloud, desative o recurso de análise de logs desse serviço no console do respectivo serviço. Verifique se o projeto não está associado a outros serviços Alibaba Cloud.

    • Sem dependências de faturamento: Verifique se todos os recursos pagos associados, como planos de armazenamento ou capacidade provisionada, foram liberados ou cancelados.

  2. Etapas para excluir um projeto

    1. Fazer backup de dados importantes (Opcional)

      • Fazer backup dos dados do Logstore: Se o projeto contém dados de log que você precisa reter, primeiro exporte os dados usando o recurso Download de logs.

      • Fazer backup das informações de configuração: Registre as configurações principais, como nome do projeto, capacidade de armazenamento e configurações de controle de acesso, para evitar a perda de informações após a exclusão.

    • Excluir o projeto

      • Na lista de projetos, localize o projeto que deseja excluir e clique em Delete na coluna Ações.

      • Na caixa de diálogo Delete Project, insira o nome do projeto, selecione um motivo para a exclusão e clique em OK.

        null

        Após a exclusão de um projeto, todos os dados de log e informações de configuração do projeto são excluídos e não podem ser restaurados. Proceda com cautela para evitar a perda de dados.

  3. Se o recurso de lixeira estiver ativado para um projeto, localize o projeto excluído na aba Recycle Bin Projects da lista de projetos. Por padrão, um projeto é mantido na lixeira por 7 dias, durante os quais você pode restaurá-lo ou excluí-lo permanentemente.

API

DeleteProject.

Gerenciar cotas de recursos

Se suas cotas de recursos forem insuficientes, solicite um aumento nas cotas de várias métricas do projeto, como o número máximo de Logstores, shards, configurações do Logtail e grupos de máquinas.

Você pode criar no máximo 150 projetos em uma conta Alibaba Cloud. Para solicitar uma cota maior, envie um ticket para solicitar o aumento.

Console

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

  2. Na seção Basic Information da página Project Overview, localize Resource Quotas e clique em Manage. No painel Resource Quotas, ajuste a cota do recurso desejado e clique em Save para enviar a solicitação. A modificação entrará em vigor em aproximadamente uma hora.

Parâmetros suportados

Métrica de cota

Descrição

Valor padrão

Limite superior

Máximo de Logstores

O número máximo de Logstores que podem ser criados em um projeto.

200

400

Máximo de shards

O número máximo de shards que podem ser criados em um projeto.

400

800

Máximo de configurações Logtail

O número máximo de configurações Logtail que podem ser criadas em um projeto.

200

400

Máximo de grupos de máquinas

O número máximo de grupos de máquinas que podem ser criados em um projeto.

200

400

Máximo de painéis

O número máximo de painéis que podem ser criados em um projeto.

100

400

Máximo de gráficos por painel

O número máximo de gráficos que podem ser incluídos em um painel.

200

400

Máximo de pesquisas salvas

O número máximo de pesquisas salvas que podem ser criadas em um projeto.

100

400

Máximo de tarefas de exportação de dados

O número máximo de tarefas de exportação que podem ser criadas em um projeto.

100

400

Máximo de tarefas de importação de dados

O número máximo de tarefas de importação que podem ser criadas em um projeto.

100

400

Máximo de tarefas de SQL agendado

O número máximo de tarefas de SQL agendado que podem ser criadas em um projeto.

100

400

Máximo de tarefas de transformação

O número máximo de tarefas de transformação de dados que podem ser criadas em um projeto.

100

400

Máximo de regras de alerta

O número máximo de alertas que podem ser criados em um projeto.

100

400

Máximo de tarefas de assinatura

O número máximo de tarefas de rastreamento que podem ser criadas em um projeto.

100

400

Tráfego máximo de gravação por projeto (GB/minuto)

O tráfego total de gravação de todos os Logstores em um projeto em 1 minuto.

100

200

Máximo de gravações por projeto (10.000 gravações/minuto)

O número total de operações de gravação em todos os Logstores em um projeto em 1 minuto.

60

200

Máximo de leituras por projeto (10.000 leituras/minuto)

O número total de operações de leitura em todos os Logstores em um projeto em 1 minuto.

60

200

Acelerar a transferência de logs entre regiões

Para transferências de logs de longa distância, como de uma região fora da China continental para uma dentro dela, ative o recurso de aceleração de transferência. Esse recurso utiliza uma rede global de data centers e roteamento inteligente para direcionar solicitações ao ponto de acesso SLS mais próximo, melhorando significativamente as velocidades de transferência por meio de caminhos de rede e protocolos otimizados. Você será cobrado pela aceleração de transferência com base no volume de dados transferidos.

Console

Ativar a aceleração de transferência

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

  2. Na seção Endpoint da página Project Overview, 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 transmissão será aprimorada ao usar o Logtail para coletar logs ou executar tarefas de transformação de dados.

API

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

  2. Para usar esse recurso, defina o parâmetro endpoint como um endpoint de aceleração. Os endpoints de aceleração suportam acesso via API apenas por HTTP e HTTPS. Eles não suportam outros protocolos, como Kafka ou gRPC. Em cenários nos quais a aceleração de transferência não é necessária, use endpoints para reduzir os custos de transmissão.

        /**
             * This example obtains 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 of SLS. Use an acceleration endpoint.
             */String endpoint = "log-global.aliyuncs.com";
            /**
             * Create an SLS client.
             */static Client client = new Client(host, accessId, accessKey);

Gerenciar grupos de recursos

Para agrupar projetos, use tags ou grupos de recursos. A principal diferença é o escopo do agrupamento. As tags são usadas para agrupamento e gerenciamento no nível do projeto. Os grupos de recursos fornecem um mecanismo de gerenciamento de recursos no nível da conta Alibaba Cloud.

Definir grupos de recursos

Um projeto pode pertencer a apenas um grupo de recursos.

Console

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

  2. Na seção Resource Group Details da página Project Overview, passe o cursor sobre o ID do grupo de recursos, clique em Modify e selecione um novo grupo de recursos.

API

ChangeResourceGroup.

Definir tags

Console

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

  2. Na seção Tag da página Project Overview, clique em Edit e configure as tags.

API

TagResources.

Visualizar nomes de domínio e configurar um nome de domínio personalizado

Visualize as informações de nome de domínio ou substitua um nome de domínio público por um nome de domínio personalizado. Após configurar um nome de domínio personalizado, use-o como endpoint nas chamadas de API.

Console

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

  2. Na seção Endpoint da página Project Overview, visualize as informações de domínio do projeto atual.

  3. Na seção Basic Information da página Project Overview, passe o cursor sobre Custom Domain e clique em Modify. No painel Specify Custom Endpoint, insira o nome de domínio e clique em Bind. Para mais informações, consulte Registrar um nome de domínio.

  4. No console do Alibaba Cloud DNS, crie um registro CNAME para apontar seu domínio personalizado para o endpoint público. Defina Record Value como o Public Endpoint registrado na página Project Overview do SLS. Para mais informações, consulte Registro CNAME.

API

CreateDomain.

Monitorar recursos do projeto

Use o recurso de log de serviço para obter vários tipos de logs, incluindo logs de operação para ações como criação, modificação, atualização e exclusão. Ele também fornece logs de execução de tarefas para jobs como SQL agendado, importação de dados e envio de dados, bem como logs de latência de consumo para grupos de consumidores em um Logstore e logs de erro, heartbeat e estatísticas do Logtail.

Console

  1. Faça login no console do Simple Log Service. Na seção de projetos, clique no nome do 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 serviço a serem ativados e o projeto de destino.

    • Logs detalhados: Fornecem logs de operação completos. Esse recurso é cobrado com base no modelo de pagamento conforme o uso.

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

    • Logs operacionais de tarefas: Fornecem os logs de execução de importação de dados, SQL agendado e tarefas de envio de dados. Esse recurso é gratuito.

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

Referência

Para armazenar diferentes tipos de dados em um projeto, é necessário criar diferentes tipos de stores. Para mais informações, consulte Gerenciar stores.