Manage shards

Split a shard

1. Log on to the Log Service console.
2. In the Projects section, click the target project.
3. Choose Log Management > Logstores. Click the management icon of the target Logstore, and then select > Modify.
4. On the Logstore Attributes page, click Modify in the upper-right corner.
5. Find the shard that you want to split, and click Split in the Actions column.
   Note The shard that you split must be in the readwrite state.

   
6. Select the number of new shards into which you want to split the original shard, and click OK.
7. Click Save.

   After the shard is split, the status of the shard changes from readwrite to readonly. You can consume data in the shard, but you cannot write data to the shard. Newly generated shards are in the readwrite state, and they are listed below the original shard. Their MD5 value ranges cover the MD5 value range of the original shard.

Enable automatic sharding

You can enable the automatic sharding feature when you create or modify a Logstore. After you enable the feature, you must specify the maximum number that the shards can be split into in the Logstore.

• Automatic sharding

  If automatic sharding is enabled, shards are automatically split based on the data traffic if the data traffic exceeds the service capacity of existing shards.

• Maximum shards

  The maximum number that shards can be automatically split into is 64 shards.

Merge shards

You can merge shards of a Logstore. When you specify a shard for merging, Log Service locates the shard next to the specified shard, and then merges the two shards.

1. Choose Log Management > Logstores. Click the management icon of the target Logstore, and then select > Modify.
2. On the Logstore Attributes page, click Modify in the upper-right corner.
3. Specify the shard that you want to merge, and click Merge in the Actions column.
   
4. Click Save.

Delete a shard

• Automatic deletion

  You can specify a data retention period when you create a Logstore. If you specify the retention period, shards and the data that is stored in the shards are automatically deleted when the retention period expires.

• Manual deletion

  You can turn on the permanent retention switch when you create a Logstore. If you turn on the switch, we recommend that you delete a Logstore if you want to delete the shards and data from the Logstore. For more information, see Delete a Logstore.