Azure 受控執行個體 for Apache Cassandra 透過 Azure 監視器 提供指標與診斷記錄。
Note
本文提及白名單一詞,但 Microsoft 已不再使用白名單。 從軟體中移除該字詞時,我們也會將其從本文中移除。
Azure 受控執行個體 for Apache Cassandra 計量
您可以在 Azure 入口網站中,前往叢集資源並選擇「指標」來視覺化 Azure 受控執行個體 for Apache Cassandra 的指標。 接著,您可以從可用的指標與彙總中選擇。
Azure 中的診斷設定
Azure 監視器 使用診斷設定來收集資源日誌,這些日誌也稱為資料平面日誌。 Azure 資源會發布資源日誌,以提供豐富且頻繁的運作資料。 Azure 監視器 會依請求擷取這些日誌。 資料平面操作的例子包括 刪除、 插入和 readFeed。 這些記錄的內容會依資源類型而有所不同。
平台指標與活動日誌會自動收集。 您必須建立診斷設定以收集資源記錄或將其轉寄到 Azure 監視器 之外。 您可以為 Apache Cassandra 叢集資源的 Azure 受控執行個體 啟用診斷設定,並將資源日誌傳送至以下來源:
- Log Analytics 工作區。 傳送至 Log Analytics 工作區的資料會寫入 Azure 診斷(舊版)或資源專屬(預覽)資料表中。
- 事件中樞。
- 儲存體帳戶。
Note
我們建議您以資源專屬模式建立診斷設定。
使用 Azure 入口網站建立診斷設定
登入 Azure 入口網站。
前往您的 Azure 受控執行個體 for Apache Cassandra 叢集資源。
在監控區段中選取「診斷設定」,然後選取「新增診斷設定」。
在 「診斷設定 」窗格中,為您的設定選擇一個名稱。
在「類別詳細資料」中,選取您的類別。 CassandraLogs 類別記錄 Cassandra 伺服器操作。 CassandraAudit 類別記錄稽核與 Cassandra 查詢語言(CQL)操作。
在 「目的地詳細資料」 下,選擇您偏好的日誌目的地。 若要將日誌傳送至 Log Analytics 工作區,請務必選擇「資源專屬」作為目標資料表。
Note
如果您將日誌傳送至 Log Analytics 工作區,它們可能需要長達 20 分鐘才能顯示。 在此之前,顯示於 Azure 受控執行個體 for Apache Cassandra 下的資源專用資料表暫時無法看見。
設定診斷記錄且資料正在流動後,您可以選擇「日誌」並使用 Azure Data Explorer 查詢可用的診斷日誌。 如需更多關於 Azure 監視器 與 Kusto 查詢語言的資訊,請參閱「Azure 監視器 中的記錄查詢」。
使用 Azure CLI 建立診斷設定
若要使用 Azure CLI 建立診斷設定,請使用 az monitor diagnostic-settings create 指令:
logs='[{"category":"CassandraAudit","enabled":true,"retentionPolicy":{"enabled":true,"days":3}},{"category":"CassandraLogs","enabled":true,"retentionPolicy":{"enabled":true,"days":3}}]'
resourceId='/subscriptions/{SUBSCRIPTION_ID}/resourceGroups/{RESOURCE_GROUP}/providers/Microsoft.DocumentDB/cassandraClusters/{CLUSTER_NAME}'
workspace='/subscriptions/{SUBSCRIPTION_ID}/resourcegroups/{RESOURCE_GROUP}/providers/microsoft.operationalinsights/workspaces/{WORKSPACE_NAME}'
az monitor diagnostic-settings create --name tvk-diagnostic-logs-cassandra --resource $resourceId --logs $logs --workspace $workspace --export-to-resource-specific true
使用 REST API 建立診斷設定
使用 Azure 監視器 REST API 透過互動式主控台建立診斷設定。 欲了解更多資訊,請參閱 診斷設定。
Note
建議將 logAnalyticsDestinationType 屬性設為 Dedicated,以啟用資源專屬資料表。
Request
PUT
https://management.azure.com/{resource-id}/providers/microsoft.insights/diagnosticSettings/service?api-version={api-version}
標頭
| 參數/標頭 | 值/描述 |
|---|---|
name |
您的診斷設定名稱 |
resourceUri |
subscriptions/{SUBSCRIPTION_ID}/resourceGroups/{RESOURCE_GROUP}/providers/Microsoft.DocumentDb/databaseAccounts/{ACCOUNT_NAME}/providers/microsoft.insights/diagnosticSettings/{DIAGNOSTIC_SETTING_NAME} |
api-version |
2017-05-01-preview |
Content-Type |
application/json |
機身
{
"id": "/subscriptions/{SUBSCRIPTION_ID}/resourceGroups/{RESOURCE_GROUP}/providers/Microsoft.DocumentDb/databaseAccounts/{ACCOUNT_NAME}/providers/microsoft.insights/diagnosticSettings/{DIAGNOSTIC_SETTING_NAME}",
"type": "Microsoft.Insights/diagnosticSettings",
"name": "name",
"location": null,
"kind": null,
"tags": null,
"properties": {
"storageAccountId": null,
"serviceBusRuleId": null,
"workspaceId": "/subscriptions/{SUBSCRIPTION_ID}/resourcegroups/{RESOURCE_GROUP}/providers/microsoft.operationalinsights/workspaces/{WORKSPACE_NAME}",
"eventHubAuthorizationRuleId": null,
"eventHubName": null,
"logs": [
{
"category": "CassandraAudit",
"categoryGroup": null,
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
},
{
"category": "CassandraLogs",
"categoryGroup": null,
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
}
],
"logAnalyticsDestinationType": "Dedicated"
},
"identity": null
}
稽核白名單
Note
本文包含對白名單一詞的參考,而 Microsoft 已不再使用白名單。 從軟體中移除該字詞時,我們也會將其從本文中移除。
預設情況下,稽核記錄會為每次登入嘗試及 CQL 查詢建立記錄。 結果可能令人不知所措,並增加額外負擔。 為了管理此情況,您可以使用白名單選擇性地納入或排除特定的稽核紀錄。
Cassandra 3.11
在 Cassandra 3.11 中,您可以使用稽核白名單功能來設定哪些操作 不會 建立稽核紀錄。 在 Cassandra 3.11 中,稽核白名單功能預設已啟用。 若要了解如何設定您的白名單,請參閱 「基於角色的白名單管理」。
範例:
若要從稽核記錄中過濾使用者
bob的所有SELECT和MODIFY操作,請執行下列語句:cassandra@cqlsh> ALTER ROLE bob WITH OPTIONS = { 'GRANT AUDIT WHITELIST FOR SELECT' : 'data' }; cassandra@cqlsh> ALTER ROLE bob WITH OPTIONS = { 'GRANT AUDIT WHITELIST FOR MODIFY' : 'data' };若要從稽核記錄中篩除使用者
decisions在鍵空間SELECT中的design資料表上執行的所有jim操作,請執行下列語句:cassandra@cqlsh> ALTER ROLE jim WITH OPTIONS = { 'GRANT AUDIT WHITELIST FOR SELECT' : 'data/design/decisions' };若要撤銷使用者
SELECT在其所有bob操作上的白名單,請執行下列語句:cassandra@cqlsh> ALTER ROLE bob WITH OPTIONS = { 'REVOKE AUDIT WHITELIST FOR SELECT' : 'data' };若要檢視目前的白名單,請執行下列語句:
cassandra@cqlsh> LIST ROLES;
Cassandra 4 及以後版本
在 Cassandra 4 及更新版本中,您可以在 Cassandra 設定中設定白名單。 如需更多資訊,請參閱 「更新 Cassandra 設定」。 可用的選項如下(參考: Cassandra 審計日誌文件):
audit_logging_options:
included_keyspaces: <Comma separated list of keyspaces to be included in audit log, default - includes all keyspaces>
excluded_keyspaces: <Comma separated list of keyspaces to be excluded from audit log, default - excludes no keyspace except system, system_schema and system_virtual_schema>
included_categories: <Comma separated list of Audit Log Categories to be included in audit log, default - includes all categories>
excluded_categories: <Comma separated list of Audit Log Categories to be excluded from audit log, default - excludes no category>
included_users: <Comma separated list of users to be included in audit log, default - includes all users>
excluded_users: <Comma separated list of users to be excluded from audit log, default - excludes no user>
可用的類別為:QUERY、DML、DDL、DCL、OTHER、AUTH、ERROR、PREPARE。
以下是一個範例配置:
audit_logging_options:
included_keyspaces: keyspace1,keyspace2
included_categories: AUTH,ERROR,DCL,DDL
預設情況下,配置會設定 included_categories 為 AUTH,ERROR,DCL,DDL。
下一步
- 如需如何透過 Azure 入口網站、Azure CLI 或 PowerShell 建立診斷設定的詳細資訊,請參閱〈Azure 監視器 中的診斷設定〉。