Manage projects

Console

1. Log on to the Simple Log Service console. In the Projects section, click Create Project.

2. Configure the project:

   1. Region: Select a region based on your log source location. The region cannot be changed after creation. To collect ECS logs over the internal network, select the same region as the ECS instances.

   2. Project name: Must be globally unique within Alibaba Cloud. Cannot be changed after creation.

   3. Leave the other parameters at their default values.

API

CreateProject.

Console

Enable the recycle bin feature

1. Log on to the Simple Log Service console. In the Projects section, click the name of the target project.

2. On the Project Overview page, in the Basic Information section, locate the Recycle Bin and click Enable if it is disabled.

API

Modify the recycleBinEnabled parameter in the UpdateProject operation.

Console

1. Clear resources before deletion

   • No associated resources:

     • When you enable log analysis for Alibaba Cloud services (elastic computing, storage, security, databases, etc.), SLS automatically creates a corresponding project and Logstore. To remove these logs, disable log analysis in the respective service console. Verify that the project is not associated with other services.

   • No billing dependencies: Ensure any associated paid resources, such as storage plans or provisioned capacity, are released or unsubscribed from.

2. Steps to delete a project

   1. Back up important data (optional)

      • Back up Logstore data: If the project contains log data that you need to retain, export the data first using the Download logs feature.

      • Back up configuration information: Record key configurations such as the project name, storage capacity, and access control settings.

   • Delete the project

     • In the project list, find the project to delete and click Delete.

     • In the Delete Project dialog box, enter the project name, select a reason, and click OK.

       Warning

       All log data and configuration in the project are permanently deleted and cannot be restored. Proceed with caution.

     • Confirm by entering the project name when prompted.

3. If the recycle bin feature is enabled for a project, you can find a deleted project on the Recycle Bin Projects tab in the project list. By default, a project is retained in the recycle bin for 7 days. During this period, you can restore or permanently delete it.

API

DeleteProject.

Console

1. Log on to the Simple Log Service console. In the Projects section, click the name of the target project.

2. In the Basic Information section of the Project Overview page, find Resource Quotas and click Manage. In the Resource Quotas panel, adjust the quota for the desired resource and click Save. The change takes effect in about one hour.

Console

Enable transfer acceleration

1. Log on to the Simple Log Service console. In the Projects section, click the name of the target project.

2. On the Project Overview page, in the Endpoint section, locate the Acceleration Endpoint and click Enable. Read the message in the dialog box and click Modify.

3. Transfer acceleration improves speeds for Logtail log collection and data transformation jobs.

API

1. Configure transfer acceleration.

2. Set the endpoint parameter to an acceleration endpoint. Acceleration endpoints support only HTTP and HTTPS, not Kafka or gRPC. When acceleration is not needed, use standard endpoints to reduce costs.

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

Console

1. Log on to the Simple Log Service console. In the Projects section, click the name of the target project.

2. In the Resource Group Details section of the Project Overview page, hover over the resource group ID, click Modify, and then select a new resource group.

API

ChangeResourceGroup.

Console

1. Log on to the Simple Log Service console. In the Projects section, click the name of the target project.

2. In the Tag section of the Project Overview page, click Edit, and then configure the tags.

API

Attach a tag.

Console

1. Log on to the Simple Log Service console. In the Projects section, click the name of the target project.

2. In the Endpoint section of the Project Overview page, view the domain information for the project.

3. Hover your mouse over Specify Custom Endpoint > Specify Custom Endpoint > Specify Custom Endpoint, then click Specify Custom Endpoint. In the Specify Custom Endpoint panel, click Bind. Register a domain name.

4. In the Alibaba Cloud DNS console, create a CNAME record to bind your domain. Set Record Value to the Public Endpoint on the Project Overview page under Basic Information > Endpoint. CNAME record.

API

CreateDomain.

Console

1. Log on to the Simple Log Service console. In the Projects section, click the name of the target project.

2. On the Enable Detailed Logs page for the project, click Enable Detailed Logs. In the Modify Service Log Settings panel, select the service logs to enable and the target project.

   • 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.

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

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