Manage projects

Console

1. Sign in to the Simple Log Service (SLS) console. In the Projects section, click Create Project.

2. Configure the project:

   1. Region: Select an Alibaba Cloud region based on the location of your log sources. After a project is created, you cannot change its region, and SLS does not support cross-region project migration. If you want to collect logs from ECS instances, we recommend that you select the same region as the ECS instances. This configuration enables log collection over the Alibaba Cloud internal network for faster performance.

   2. Project name: The project name must be globally unique within an Alibaba Cloud region and cannot be changed after creation.

   3. Leave the other settings at their default values.

API

CreateProject.

Console

Enable the recycle bin feature

1. Sign in to the Simple Log Service (SLS) console. In the Projects section, click the target project.

2. On the project overview page, in the Basic Information section, find Project recycle bin and click Enable if it is not already enabled.

API

Set the recycleBinEnabled parameter in the UpdateProject operation.

Console

1. Pre-deletion cleanup

   • No associated resources:

     • When you enable log analysis for various Alibaba Cloud services such as elastic computing, storage, security, and databases, SLS automatically creates a corresponding project and LogStore in the console. If you no longer need the logs from a cloud service, you must disable the log analysis feature in the console of that service. Ensure the project is not associated with other Alibaba Cloud services.

   • No billing dependencies: If the project is associated with a paid plan, such as a storage package or reserved capacity, you must first unsubscribe from or release the resources.

2. Procedure

   • Back up important data (optional)

     • LogStore data backup: If the project contains log data that you need to retain, use the SLS Download logs feature to export it beforehand.

     • Configuration backup: Record key settings such as the project name, storage capacity, and access control policies to prevent information loss after deletion.

   • Delete the project

     • In the project list, find the project that you want to delete and click Delete in the Actions column.

       Troubleshoot the ProjectDeletionNotAllowed error

       • Symptom: When you try to delete a project, the system returns the ProjectDeletionNotAllowed error.

       • Cause: The project has deletion protection enabled. Deletion protection is a security feature that prevents accidental deletion of a project. When enabled, you cannot delete the project directly from the console or by using the API.

       • Solution: You must first disable deletion protection before you can delete the project.

         • Sign in to the SLS console and click the target project in the project list. On the project overview page, find the deletion protection switch in the Basic Information section and turn it off.

     • In the Delete Project panel, enter the project name, select a reason for deletion, and then click OK.

       Warning

       After a project is deleted, all its log data and configuration information are permanently deleted and cannot be recovered. Confirm your action carefully before you delete a project to prevent data loss.

     • Confirm the operation: Read the prompt and enter the project name for a second confirmation.

3. If the recycle bin feature is enabled for the project, you can find the deleted project in the Recycle Bin Projects tab of the project list. By default, a project remains in the recycle bin for 7 days, during which you can restore or permanently delete it.

4. Confirm the deletion status

   • Deletion is an asynchronous operation. After you submit a deletion request, the system gradually cleans up the project in the background. If you try to delete the same project again and receive a "Project does not exist" message, it usually means the project has been successfully deleted.

   • Go to the SLS console and check if the target project has disappeared from the project list. If the list is empty, all project resources in that region have been cleared.

   • If you have enabled the recycle bin, also check the Recycle Bin Projects list to confirm if the project was permanently deleted or restored.

API

DeleteProject.

Console

1. Sign in to the Simple Log Service (SLS) console. In the Projects section, click the target project.

2. On the project overview page, go to the Basic Information section, find Resource quotas, and click Manage. In the Resource Quotas panel, adjust the quota for the target resource and click Save to submit your request. The change takes about one hour to take effect.

Console

Enable transfer acceleration

1. Sign in to the Simple Log Service (SLS) console. In the Projects section, click the target project.

2. On the project overview page, go to the Endpoints section, find Acceleration endpoint, and click Enable. Read the message in the dialog box and then click Modify.

3. After you enable transfer acceleration, the transfer speed is improved when you use Logtail for log collection and when you run data transformation jobs.

API

1. First, call the PutProjectTransferAcceleration operation.

2. To use the acceleration feature, you must set the endpoint to the acceleration endpoint. Acceleration endpoints support API access only over HTTP and HTTPS, and do not support protocols such as Kafka or gRPC. In scenarios where transfer acceleration is not required, we recommend using a standard service endpoint to reduce transfer costs.

       /**
            * 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);

Console

1. Sign in to the Simple Log Service (SLS) console. In the Projects section, click the target project.

2. On the project overview page, in the Resource group details section, hover over the Resource group ID, click Modify, and then select a resource group.

API

ChangeResourceGroup.

Console

1. Sign in to the Simple Log Service (SLS) console. In the Projects section, click the target project.

2. On the project overview page, in the Tags section, click Edit, and then set tags in the Edit tag panel.

API

TagResources.

Console

1. Sign in to the Simple Log Service (SLS) console. In the Projects section, click the target project.

2. On the project overview page, go to the Endpoints section to view the endpoint information for the current project.

3. On the project overview page, in the Basic Information section, hover over Custom domain, click Set. In the Specify Custom Endpoint panel, configure the domain name, and then click Bind.

4. In the Alibaba Cloud DNS console, add a CNAME record to activate the domain binding. Set the Record Value to the Public Endpoint listed in the Endpoints section on the project overview page. For detailed instructions, see CNAME record.

API

CreateDomain.

Console

1. Sign in to the Simple Log Service (SLS) console. In the Projects section, click the target project.

2. On the Service log page of the project, click Enable Detailed Logs. In the Modify service log settings panel, select the service logs you want to enable and the project where they will be stored.

   • Detailed logs: Provides complete operation logs. This is a pay-as-you-go feature.

   • Important logs: Provides metering logs, consumer group latency logs, and Logtail heartbeat logs. This feature is free of charge.

   • Task operational logs: Provides the operational logs of data import tasks, scheduled SQL jobs, and shipping tasks. This feature is free of charge.

   • Log storage location: Choose an existing project or let the system automatically create a new one to store these logs.