全部產品
Search
文件中心

:ALIYUN::SLS::Logstore

更新時間:Nov 19, 2024

ALIYUN::SLS::Logstore類型用於在記錄項目下建立日誌庫。

文法

{
  "Type": "ALIYUN::SLS::Logstore",
  "Properties": {
    "ProjectName": String,
    "ShardCount": Integer,
    "AutoSplit": Boolean,
    "MaxSplitShard": Integer,
    "LogstoreName": String,
    "AppendMeta": Boolean,
    "TTL": Integer,
    "EnableTracking": Boolean,
    "PreserveStorage": Boolean,
    "EncryptConf": Map,
    "Mode": String
  }
}

屬性

屬性名稱

類型

必須

允許更新

描述

約束

ProjectName

String

要建立的日誌庫所屬記錄項目的名稱。

長度為3~36個字元。

支援小寫英文字母、數字、短劃線(-)、底線(_)。必須以小寫英文字母或數字開頭和結尾。

ShardCount

Integer

分區個數。

取值範圍:1~100。

預設值:2。

單位:個。

MaxSplitShard

Integer

自動分裂時,分裂出最大的分區個數。

取值範圍:1~64。

當autoSplit為true時,必須指定MaxSplitShard。

LogstoreName

String

日誌庫的名稱。

在一個記錄項目中,日誌庫的名稱必須具有唯一性。

  • 長度為3~36個字元。

  • 支援小寫英文字母、數字、短劃線(-)、底線(_)。

  • 必須以小寫英文字母或數字開頭和結尾。

AutoSplit

Boolean

是否自動分裂分區。

取值:

  • true:自動分裂分區。

  • false(預設值):不自動分裂分區。

TTL

Integer

資料的儲存時間。

取值範圍:1~3600。

預設值:30。

單位:天。

EnableTracking

Boolean

是否開啟WebTracking採集資訊。

支援採集各種瀏覽器以及iOS或Android App的資訊。

取值:

  • true:開啟WebTracking採集資訊。

  • false(預設值):不開啟WebTracking採集資訊。

PreserveStorage

Boolean

是否永久儲存日誌。

取值:

  • true:永久儲存日誌。如果取值為true,則TTL的設定不生效。

  • false(預設值):不永久儲存日誌。

Mode

String

Logstore的類型。

取值:

  • standard(標準型):支援Log Service一站式資料分析功能,適用於即時監控、互動式分析以及構建完整的可觀測性系統等情境。

  • query(查詢型):支援高效能查詢,索引流量費用約為Standard的一半,但不支援SQL分析,適用於資料量大、儲存周期長(周、月層級以上)、無日誌分析的情境。

AppendMeta

Boolean

接收日誌後,是否自動添加用戶端外網IP和日誌到達時間。

取值:

  • true:自動添加用戶端外網IP和日誌到達時間。

  • false(預設值):不自動添加用戶端外網IP和日誌到達時間。

EncryptConf

Map

資料加密配置。

更多資訊,請參見EncryptConf文法EncryptConf屬性

EncryptConf文法

"EncryptConf": {
    "Enable": Boolean,
    "EncryptType": String,
    "UserCmkInfo": Map
}

EncryptConf屬性

屬性名稱

類型

必須

允許更新

描述

約束

Enable

Boolean

是否啟用資料加密。

取值:

  • true:啟用資料加密。

  • false(預設值):不啟用資料加密。

EncryptType

String

密碼編譯演算法。

取值:

  • default:AES演算法。

  • m4:國密演算法。

說明

關於資料加密的更多資訊,請參見資料加密

UserCmkInfo

Map

如果指定了UserCmkInfo,則使用內建密鑰(BYOK)加密或解密資料。否則,將使用Log Service的服務密鑰。

更多資訊,請參見UserCmkInfo文法UserCmkInfo屬性

UserCmkInfo文法

"UserCmkInfo": {
    "CmkKeyId": String,
    "Arn": String,
    "RegionId": String
  }

UserCmkInfo屬性

屬性名稱

類型

必須

允許更新

描述

約束

CmkKeyId

String

BYOK密鑰所屬的CMK的ID。

RegionId

String

CMK所在地區的ID。

Arn

String

RAM角色的ARN。

關於如何擷取RAM角色的ARN的更多資訊,請參見建立OSS投遞任務(舊版)

傳回值

Fn::GetAtt

  • LogstoreName:日誌庫名稱。

  • ProjectName:記錄項目的名稱。

樣本

YAML格式

ROSTemplateFormatVersion: '2015-09-01'
Description: Test SLS Logstore
Parameters: {}
Resources:
  SlsLogStore:
    Type: ALIYUN::SLS::Logstore
    Properties:
      LogstoreName: mytest
      PreserveStorage: true
      ProjectName: TestProject
      AppendMeta: true
      MaxSplitShard: 64
      AutoSplit: true
      EnableTracking: false
      ShardCount: 2
Outputs: {}

JSON格式

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "Test SLS Logstore",
  "Parameters": {
  },
  "Resources": {
    "SlsLogStore": {
      "Type": "ALIYUN::SLS::Logstore",
      "Properties": {
        "LogstoreName": "mytest",
        "PreserveStorage": true,
        "ProjectName": "TestProject",
        "AppendMeta": true,
        "MaxSplitShard": 64,
        "AutoSplit": true,
        "EnableTracking": false,
        "ShardCount": 2
      }
    }
  },
  "Outputs": {
  }
}

更多樣本,請參見建立記錄項目、建立日誌庫、建立索引、配置Logtail參數、建立Log ServiceECS機器組、將日誌配置應用於機器組、建立日誌配置、將查詢結果儲存為快速查詢和建立警示的組合樣本:YAML樣本