By default, ActionTrail allows you to query the events that are recorded within your Alibaba Cloud account in the last 90 days. You may also need to analyze the events that are recorded in the last 90 days or retain events for 180 days or longer for your enterprise. In this case, you must deliver the events that are recorded in the ActionTrail console to a specified data analysis service, or continuously collect events from Alibaba Cloud and save the events to a specified storage service. You can use ActionTrail trails to meet the preceding requirements. This topic describes how to deliver events to a specified destination in different scenarios by using a single-account trail.
Prerequisites
- Object Storage Service (OSS) is activated. For more information, see Activate OSS.
- Log Service is activated.
If Log Service is not activated, log on to the Log Service console and follow the on-screen instructions to activate the service.
Scenarios
You can create a trail in the ActionTrail console to deliver events in various scenarios. If you do not create a trail, you cannot query the events that are generated more than 90 days ago. You can create a trail to deliver events in the following scenarios:
- Scenario 1: Retain events for 180 days or longer
By default, ActionTrail records only the events that are generated in the last 90 days. Multi-Level Protection Scheme (MLPS) 2.0 requires events to be retained for 180 days or longer. In this case, you can create a trail to continuously collect events and deliver the events to OSS or Log Service. By default, events are permanently stored after they are delivered to an OSS bucket or a Log Service Logstore. If you want to retain events for only 180 days, see Modify the lifecycle rule of the OSS bucket or Change the data retention period of the Log Service Logstore.
- Scenario 2: Analyze sensitive operations and configure alert rules for the operations
If you want to detect sensitive operations at the earliest opportunity, such as the operations that are performed to generate orders or delete resources, you can create a trail in the ActionTrail console to deliver the related events to a specified Log Service Logstore. Then, you can configure alert rules for the events in the Log Service console.
- Scenario 3: Analyze events by using MaxCompute
If Log Service does not meet your analysis requirements, we recommend that you use MaxCompute to analyze events. MaxCompute provides various classic distributed computing models to help you perform big data analysis in an efficient manner. You can create a trail to deliver events to a specified Log Service Logstore. Then, you can configure the Logstore to import the events to MaxCompute for analysis.
- Scenario 4: Analyze and permanently store events in a cost-effective manner
Before you use OSS, Log Service, and MaxCompute to perform real-time analysis and ensure permanent storage of events, make sure that you are familiar with the features and billing policies of the services. Log Service, MaxCompute, and OSS are paid services, which are listed in descending order of price. We recommend that you process events in the following manner: Create a trail to deliver events to a specified Log Service Logstore for analysis. Change the data retention period of the Logstore in the Log Service console to meet the retention requirements of real-time analysis. Then, configure the Logstore to import events to MaxCompute or OSS for permanent storage at regular intervals.
Scenario 1: Retain events for 180 days or longer
- Log on to the ActionTrail console.
- In the left-side navigation pane, click Trail.
- In the top navigation bar, select the region where you want to create a trail.
- On the Trail page, click Create Trail.
- On the Create Trail page, configure the required parameters.
- In the Basic Information section, configure the basic information about the trail.
Parameter Description Trail Name The name of the trail that you want to create. The name must be unique within your Alibaba Cloud account. Log Events Set the Management Event to All. - In the Event Delivery section, configure a delivery method.
- Select Delivery to Log Service and then select Delivery to Current Account.
- New Log Service Project: If you select this option, select a region from the Logstore Region drop-down list and configure the Project Name parameter.
- Existing Log Service Project: If you select this option, select a region from the Logstore Region drop-down list and a project name from the Project Name drop-down list.
- Select Delivery to OSS and then select Delivery to Current Account.
- New OSS Bucket: If you select this option, configure the Bucket Name, Log File Prefix, Enable Server-side Encryption, and Enable Retention Policy parameters.
- Existing OSS Bucket: If you select this option, configure the Bucket Name parameter.
- Select Delivery to Log Service and then select Delivery to Current Account.
- In the Basic Information section, configure the basic information about the trail.
- Click Confirm. You can perform one of the following operations based on the storage service to view events:
- OSS: Click the bucket name to go to the OSS console and view the events.
- Log Service: Click the name of the Log Service project or Logstore to go to the Log Service console and view the events.
Scenario 2: Analyze sensitive operations and configure alert rules for the operations
- Log on to the ActionTrail console.
- In the left-side navigation pane, click Trail.
- In the top navigation bar, select the region where you want to create a trail.
- On the Trail page, click Create Trail.
- On the Create Trail page, configure the required parameters.
- In the Basic Information section, configure the basic information about the trail.
Parameter Description Trail Name The name of the trail that you want to create. The name must be unique within your Alibaba Cloud account. Log Events The type of events that you want to deliver. Set the Management Event to Write. Note In most cases, Write provide information about sensitive operations. You can set the Management Event to Write to reduce the size of events that you want to deliver. This helps reduce costs. - In the Event Delivery section, configure parameters to deliver events to Log Service within the current account.
- New Project: If you select this option, select a region from the Logstore Region drop-down list and configure the Project Name parameter.
- Existing Log Service Project: If you select this option, select a region from the Logstore Region drop-down list and a project name from the Project Name drop-down list.
- In the Basic Information section, configure the basic information about the trail.
- Click Confirm. On the details page of the trail, you can click the name of the Log Service project or Logstore to go to the Log Service console and view the analysis results of the events.
- In the Log Service console, configure an alert rule. For more information, see Configure an alert rule.
Scenario 3: Analyze events by using MaxCompute
- Log on to the ActionTrail console.
- In the left-side navigation pane, click Trail.
- In the top navigation bar, select the region where you want to create a trail.
- On the Trail page, click Create Trail.
- On the Create Trail page, configure the required parameters.
- In the Basic Information section, configure the basic information about the trail.
Parameter Description Trail Name The name of the trail that you want to create. The name must be unique within your Alibaba Cloud account. Log Events The type of events that you want to deliver. Set the Management Event to All. - In the Event Delivery section, configure parameters to deliver events to Log Service within the current account.
- New Log Service Project: If you select this option, select a region from the Logstore Region drop-down list and configure the Project Name parameter.
- Existing Log Service Project: If you select this option, select a region from the Logstore Region drop-down list and a project name from the Project Name drop-down list.
- In the Basic Information section, configure the basic information about the trail.
- Click Confirm. On the details page of the trail, you can click the name of the Log Service project or Logstore to go to the Log Service console and view the analysis results of the events.
- In the Log Service console, deliver the events to MaxCompute. For more information, see Ship logs to MaxCompute (old version).Note After the events are delivered to MaxCompute, you can analyze the events.
Scenario 4: Analyze and permanently store events in a cost-effective manner
If you select New Log Service Project when you create a trail in the ActionTrail console, a Log Service Logstore whose name is prefixed with actiontrail_<trail_name>
is created. By default, events are permanently stored in the Logstore. The storage that is provided by Log Service for events is not cost-effective. We recommend that you change the data retention period of the Logstore and configure the Logstore to deliver events to MaxCompute or OSS for permanent storage at regular intervals. For example, you can change the data retention period of the Logstore to 180 days.
- Create a trail in the ActionTrail console to deliver events to a specified Log Service Logstore. For more information about how to create a trail, see Create a single-account trail.
- Change the retention period of the events in the Log Service console.
- Log on to the Log Service console.
- In the Projects section, click the name of the project that you specified when you created the trail.
- Click the
icon to the left of the specified Logstore and then click the
icon.
- On the Logstore Attributes tab, click Modify in the upper-right corner and turn off Permanent Storage.
- Change the value of the Data Retention Period parameter and click Save in the upper-right corner.
- Configure the Logstore to deliver events to MaxCompute or OSS at regular intervals. For more information, see Ship log data from Log Service to OSS.