指令碼開發 / 觀測雲

觀測雲聯結器操作物件主要提供用於資料寫入的 DataWay 物件以及 OpenAPI 的封裝。

DFF.CONN(...) 引數如下：

引數	型別	必須 / 預設值	說明
connector_id	str	必須	聯結器 ID

OpenAPI 文件請參考：

• 觀測雲文件 / OpenAPI

.dataway

dataway 屬性為當前觀測雲對應的 DataWay 操作物件，使用方式與直接建立的 DataWay 聯結器操作物件相同。

status_code, result = guance.dataway.write_by_category(category='metric', measurement='主機監控', tags={'host': 'web-01'}, fields={'cpu': 10})

完整內容請參考：

• 指令碼開發 / 聯結器物件 DFF.CONN / DataKit、DataWay

.is_api_key_valid / .is_api_key_match

is_api_key_valid / is_api_key_match 屬性返回當前聯結器的 API Key 是否有效：

print(guance.is_api_key_valid)

True

.workspace

workspace 屬性返回當前工作空間資訊：

import json
print(json.dumps(guance.workspace, indent=2))

{
  "uuid"        : "wksp_xxxxx",
  "name"        : "xxxxx",
  "rpName"      : "rp1",
  "language"    : "zh",
  "timezone"    : "",
  "bossStation" : "CN",
  "billingState": "normal",
  "versionType" : "pay",
  "token"       : "tkn_xxxxx",
  "cliToken"    : "wkcli_xxxxx",
  "<其他欄位略>": "..."
}

.workspace_uuid

workspace_uuid 屬性返回當前工作空間 UUID：

print(guance.workspace_uuid)

wksp_xxxxx

.workspace_token

workspace_token 屬性返回當前工作空間 Token：

print(guance.workspace_token)

tkn_xxxxx

.workspace_language

workspace_language 屬性返回當前工作空間語言：

print(guance.workspace_language)

zh

.do_get(...)

用於向觀測雲 OpenAPI 發起 GET 請求，引數如下：

引數	型別	必須 / 預設值	說明
path	str	必須	路徑
query	dict		引數

import json

result = guance.do_get('/api/v1/workspace/get')
print(json.dumps(result, indent=2))

{
  "uuid"        : "wksp_xxxxx",
  "name"        : "xxxxx",
  "rpName"      : "rp1",
  "language"    : "zh",
  "timezone"    : "",
  "bossStation" : "CN",
  "billingState": "normal",
  "versionType" : "pay",
  "token"       : "tkn_xxxxx",
  "cliToken"    : "wkcli_xxxxx",
  "<其他欄位略>": "..."
}

.do_post(...)

用於向觀測雲 OpenAPI 發起 POST 請求，引數如下：

引數	型別	必須 / 預設值	說明
path	str	必須	路徑
query	dict		引數
body	dict		JSON 請求體

body = {
    'desc': '新描述'
}
result = guance.do_post('/api/v1/workspace/modify', body=body)

節點

觀測雲具有多個節點可供使用，在建立觀測雲聯結器時，需要指定對應的觀測雲節點。

DataFlux Func 本身為了保證支援完全離線使用，每個版本在釋出時都會儲存一份當時最新的觀測雲節點列表。

因此可能存在觀測雲新增節點後，不能在 DataFlux Func 中及時體現的情況。

遇到此類情況，可以在下列地址中查閱觀測雲新節點相關配置，然後選擇「私有部署」後手工填寫。

• urls.guance.com

當前可用的節點列表如下：

節點	名稱	地址
正在獲取最新節點列表...