跳转至

观测云工具包 / 连接到其他观测云节点

默认情况下,观测云工具包连接至观测云默认节点(杭州)。

如果需要连接到非默认节点(杭州)的观测云,则需要额外传入观测云节点(参数名guance_node)参数

1. 代码示例

在相关函数、类中指定guance_node参数,即可连接至不同的观测云节点。如:

调用 dql_query(...) 函数时

Python
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
import guance_toolkit__api as guance_toolkit

def run():
    # DQL 语句(注意不要指定时间范围)
    dql = '''T::re(`.*`)'''

    # 时间范围
    start_time = '2023-05-01T00:00:00+08:00'
    end_time   = '2023-05-01T00:00:05+08:00'

    # 工作空间 Token
    workspace_token = 'tkn_xxxxx'

    # 启动执行
    guance_toolkit.dql_export_split(dql=dql,
                                    start_time=start_time,
                                    end_time=end_time,
                                    workspace_token=workspace_token,
                                    guance_node='aws',
                                    split_interval=0)

生成 OpenWay 实例时

Python
1
2
3
4
5
from guance_toolkit__guance import OpenWay

def run():
    openway = OpenWay('tkn_xxxxx',
                      guance_node='aws')

2. 观测云节点列表

guance_node参数可选值请参考 手册 / 界面和操作 / 观测云节点 表格中的「节点」列

3. 连接到私有部署版观测云

对于部署版观测云,需要使用完整的 URL 地址指定节点,如:

调用 dql_query(...) 函数时

Python
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
import guance_toolkit__api as guance_toolkit

def run():
    # DQL 语句(注意不要指定时间范围)
    dql = '''T::re(`.*`)'''

    # 时间范围
    start_time = '2023-05-01T00:00:00+08:00'
    end_time   = '2023-05-01T00:00:05+08:00'

    # 工作空间 Token
    workspace_token = 'tkn_xxxxx'

    # 指定观测云节点
    guance_node = {
        'openapi': 'http://xxxxx-openapi.cloudcare.cn', # OpenAPI 访问地址
        'openway': 'http://xxxxx-openway.cloudcare.cn', # OpenWay 访问地址
    }

    # 启动执行
    guance_toolkit.dql_export_split(dql=dql,
                                    start_time=start_time,
                                    end_time=end_time,
                                    workspace_token=workspace_token,
                                    guance_node=guance_node,
                                    split_interval=0)

生成 OpenWay 实例时

Python
1
2
3
4
5
6
7
8
9
from guance_toolkit__guance import OpenWay

def run():
    # 指定观测云节点
    guance_node = {
        'openapi': 'http://xxxxx-openapi.cloudcare.cn', # OpenAPI 访问地址
        'openway': 'http://xxxxx-openway.cloudcare.cn', # OpenWay 访问地址
    }
    openway = OpenWay('tkn_xxxxx', guance_node=guance_node)

OpenAPI 访问地址和 OpenWay 访问地址都需要配置