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.
Criar um projeto
Crie um projeto para gerenciar todos os logs e fontes de log relacionadas de uma aplicação.
Console
Faça login no console do Simple Log Service, navegue até a seção de projetos e clique em Create Project.
Configure o projeto.
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.
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.
Mantenha os outros parâmetros com seus valores padrão.
API
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.
Faça login no console do Simple Log Service e localize o projeto desejado na lista de projetos.
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.
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.
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.
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
Faça login no console do Simple Log Service. Na seção de projetos, clique no nome do projeto desejado.
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.
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
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.
Etapas para excluir um projeto
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.
nullApó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.
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
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
Faça login no console do Simple Log Service. Na seção de projetos, clique no nome do projeto desejado.
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.
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
Faça login no console do Simple Log Service. Na seção de projetos, clique no nome do projeto desejado.
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.
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
Primeiro, chame a operação PutProjectTransferAcceleration.
Para usar esse recurso, defina o parâmetro
endpointcomo 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
Faça login no console do Simple Log Service. Na seção de projetos, clique no nome do projeto desejado.
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
Definir tags
Console
Faça login no console do Simple Log Service. Na seção de projetos, clique no nome do projeto desejado.
Na seção Tag da página Project Overview, clique em Edit e configure as tags.
API
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
Faça login no console do Simple Log Service. Na seção de projetos, clique no nome do projeto desejado.
Na seção Endpoint da página Project Overview, visualize as informações de domínio do projeto atual.
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.
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
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
Faça login no console do Simple Log Service. Na seção de projetos, clique no nome do projeto desejado.
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.