10.2 代理配置实用程序

/ 脚本用于配置代理agent.sh。agent.bat下表列出了每个支持的操作系统的默认位置：

重要的

这些参数使您能够从脚本或命令行配置 MySQL Enterprise Monitor Agent，并且只能在 MySQL Enterprise Monitor Agent 停止时运行。

表 10.4 代理配置实用程序的默认位置

操作系统 文件位置

微软Windows

C:\Program Files\MySQL\Enterprise\Agent\bin\agent.bat

UNIX/Linux

/opt/mysql/enterprise/agent/bin/agent.sh

苹果系统

/Applications/mysql/enterprise/agent/bin/agent.sh


用于--help查看其选项。

Service Manager 配置实用程序包含以下命令集：

重要的

不可能从命令行运行agent.shas root，但只能 as mysql。

代理连接实用程序

以下参数使您能够创建、测试和编辑从 MySQL Enterprise Monitor Agent 到受监视 MySQL 实例的连接。

表 10.5 代理连接实用程序

姓名 描述

--test-credentials

-T

测试 MySQL 连接凭据。

--test-privileges

测试管理员用户管理其他用户的权限。

--create-connection

-c

创建或修改 MySQL 连接。

--delete-connection

-d

关闭并删除 MySQL 连接。此参数需要--connection-id.

--show

-s

显示有关此代理上所有 MySQL 连接的信息

--auto-manage-extra-users

-m

自动创建一般/受限用户（操作：创建、修改）

--host=<value>

-h <value>

MySQL 实例的主机（操作：创建、修改）

--port=<value>

-P <value>

MySQL 实例的端口（操作：创建、修改）

--socket=<value>

-S <value>

MySQL 实例的套接字（操作：创建、修改）

--limited-user=<value>

-l <value>

有限级别的凭据（操作：创建、修改）

--general-user=<value>

-k <value>

一般用户凭据

--admin-user=<value>

-j <value>

管理员用户凭据

--connection-id=<value>

-i <value>

连接编号

--connection-group=<value>

-g <value>

指定要将此连接添加到的组的名称。如果命名组不存在，则创建它并向其添加连接。--create-connection该参数可以在命令中多次使用 。连接被添加到每个命名的组中。

--force-plain-stdin,

-f

强制使用 STDIN 进行密码输入（密码输入未被屏蔽 - 此选项仅对这些实用程序的非常特定用途有用，例如来自自动脚本的调用）

--disable-topology-discovery

禁用复制拓扑发现。如果您不使用复制，或者如果您想稍后发现拓扑，请使用此参数。拓扑发现可能非常耗时。

--mysql-identity-source=<value>

此连接的 MySQL 实例的标识源，default或 host_plus_datadir. default使用 server_uuid变量（如果存在）或生成新的 uuid。 host_and_datadir使用主机身份的散列和 MySQL 实例数据目录的路径来创建唯一身份。

--require-encryption

要求对 MySQL 连接使用 TLS。

--allow-self-signed-certs

使用 --require-encryption 时，允许自签名 TLS 证书。

--ca-file-path=<value>

使用时--require-encryption，但使用私有证书颁发机构时，CA 文件的路径。


以下示例测试 root 用户的凭据 localhost:3306： 

  agent.bat --test-credentials --admin-user=root --host=localhost --port=3306

以下示例仅使用 localhost:3306 的管理员用户创建连接： 

  agent.bat -c --admin-user=root --host=localhost --port=3306

以下示例仅使用管理员用户创建到 localhost:3306 的连接，并强制使用 STDIN 密码： 

  agent.bat -c --admin-user=root --host=localhost --port=3306 -f

以下示例仅使用 admin 用户创建到 localhost:3306 的连接，并将其添加到组 Standard、Special 和 Third： 

  agent.bat -c --admin-user=root --host=localhost --port=3306 
            --connection-group=Standard --connection-group="Special Group" 
--connection-group="Third Group"

代理配置实用程序

以下参数使您能够配置或编辑从 MySQL Enterprise Monitor Agent 到 MySQL Enterprise Service Manager 的连接。

表 10.6 MySQL Enterprise Monitor 代理配置实用程序

姓名 描述

--agent-user=<value>

-u <value>

设置代理用于连接到服务管理器的凭据

--url=<value>

-U <value>

设置服务管理器的 URL

--uuid=<value>

-I <value>

设置代理 UUID

--agent-group=<value>

-G <value>

将 MEM 组设置为用于来自此代理的所有 MySQL 连接

--force-plain-stdin

-f

强制使用 STDIN 密码输入（密码输入未被屏蔽 - 此选项仅对这些实用程序的非常特定用途有用，例如来自自动脚本的调用）

--run-collection-tests

-t

发现并尝试收集 OS 相关资产并将它们转储到 STDOUT（用于调试）


以下示例设置代理用于连接到 MySQL Enterprise Service Manager 的用户名和 URL： 

agent.sh --agent-user=agent --url=https://localhost:8443