az grafana
注意
此參考是 Azure CLI 的 amg 延伸模組的一部分(2.38.0 版或更高版本)。 擴充功能會在您第一次執行 az grafana 命令時自動安裝。 深入了解擴充功能。
管理 Azure Grafana 實例的命令。
針對優化的體驗,並非所有記載於 https://grafana.com/docs/grafana/latest/http_api/的數據平面 API 都會公開。 在涵蓋範圍差距上,請連絡 ad4g@microsoft.com。
命令
az grafana backup
此命令處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
將 Azure 受控 Grafana 實例的內容備份至封存。
az grafana backup --name
[--components {annotations, dashboards, datasources, folders, snapshots}]
[--directory]
[--folders-to-exclude]
[--folders-to-include]
[--resource-group]
範例
2 個資料夾下的備份儀錶板(資料來源包含在內,以在將儀錶板還原至另一個工作區時啟用名稱重新對應)
az grafana backup -g MyResourceGroup -n MyGrafana -d c:\temp --folders-to-include "Prod" "Compute Gateway" --components datasources dashboards folders
備份儀錶板並略過幾個資料夾
az grafana backup -g MyResourceGroup -n MyGrafana -d c:\temp --folders-to-exclude General "Azure Monitor" --components datasources dashboards folders
必要參數
Azure 受控 Grafana 的名稱。
選擇性參數
要備份的 Grafana 成品類型。
要備份 Grafana 成品的目錄。
備份或同步處理中要排除的資料夾。
要包含在備份或同步處理中的資料夾。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az grafana create
建立 Azure 受控 Grafana 執行個體。
az grafana create --name
--resource-group
[--deterministic-outbound-ip {Disabled, Enabled}]
[--location]
[--principal-ids]
[--principal-types {Group, ServicePrincipal, User}]
[--skip-role-assignments {false, true}]
[--skip-system-assigned-identity {false, true}]
[--tags]
[--zone-redundancy {Disabled, Enabled}]
必要參數
Azure 受控 Grafana 的名稱。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
選擇性參數
如果啟用,Grafana 工作區將會有固定的輸出IP,您可以在數據源的防火牆中使用它們。 預設:已停用。
位置。 值的來源:az account list-locations
。 您可以使用 az configure --defaults location=<location>
設定預設位置。
要做為 Grafana 管理員的使用者、群組等空間分隔 Azure AD 物件識別碼。 提供之後,CLI 將不會將目前的登入用戶設為 Grafana 系統管理員。
要與 --principal-ids 配對的空間分隔 Azure AD 主體類型。
請勿為受控識別和目前的登入使用者建立角色指派。
請勿啟用系統指派的身分識別。
以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。
指出是否應該啟用區域備援。 預設:已停用。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az grafana delete
刪除 Azure 受控 Grafana 實例。
az grafana delete --name
[--resource-group]
[--yes]
必要參數
Azure 受控 Grafana 的名稱。
選擇性參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
不提示確認。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az grafana list
列出 Azure 受控 Grafana 實例。
az grafana list [--resource-group]
選擇性參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az grafana restore
此命令處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
從封存還原 Azure 受控 Grafana 實例。
az grafana restore --archive-file
--name
[--components {annotations, dashboards, datasources, folders, snapshots}]
[--remap-data-sources {false, true}]
[--resource-group]
範例
還原儀錶板。 如果它們位於資料夾下,請在元件清單中包含「資料夾」;使用 「--remap-data-sources」,因此 CLI 會更新儀錶板以指向目標工作區的相同數據源
az grafana restore -g MyResourceGroup -n MyGrafana --archive-file backup\dashboards\ServiceHealth-202307051036.tar.gz --components dashboards folders --remap-data-sources
必要參數
要從中還原 Grafana 成品的封存。
Azure 受控 Grafana 的名稱。
選擇性參數
要備份的 Grafana 成品類型。
在還原期間,透過名稱比對,更新儀錶板以參考目的地工作區所定義的數據源。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az grafana show
顯示 Azure 受控 Grafana 實例的詳細數據。
az grafana show --name
[--resource-group]
必要參數
Azure 受控 Grafana 的名稱。
選擇性參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az grafana update
更新 Azure 受控 Grafana 實例。
az grafana update --name
[--api-key {Disabled, Enabled}]
[--deterministic-outbound-ip {Disabled, Enabled}]
[--from-address]
[--from-name]
[--host]
[--major-version]
[--password]
[--public-network-access {Disabled, Enabled}]
[--resource-group]
[--skip-verify {false, true}]
[--smtp {Disabled, Enabled}]
[--start-tls-policy {MandatoryStartTLS, NoStartTLS, OpportunisticStartTLS}]
[--tags]
[--user]
範例
停用公用網路存取
az grafana update -g MyResourceGroup -n MyGrafana --public-network-access disabled
透過 MAILgun 的 SMTP 轉送裝置啟用郵件通知
az grafana update -g MyResourceGroup -n MyGrafana --smtp enabled --from-address johndoe@outlook.com --from-name john --host "smtp.mailgun.org:587" --user "postmaster@sandbox12345.mailgun.org" --password "password" --start-tls-policy OpportunisticStartTLS --skip-verify true
必要參數
Azure 受控 Grafana 的名稱。
選擇性參數
如果已啟用,您將能夠設定 Grafana API 金鑰和服務帳戶。
如果啟用,Grafana 工作區將會有固定的輸出IP,您可以在數據源的防火牆中使用它們。
傳送電子郵件時所使用的位址。
傳送電子郵件時要使用的名稱。
SMTP 伺服器 URL(包含埠)。
Grafana 主要版本號碼。
SMTP 伺服器用戶密碼。
允許公用網路存取。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
略過 SMTP 伺服器的 SSL 驗證。
允許 Grafana 傳送電子郵件。
TLS 原則。
以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。
SMTP 伺服器用戶名稱。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應