此页面由 Cloud Translation API 翻译。

如何监控

适用于私有云的 Edge v. 4.17.09

本文档介绍了本地部署所支持的组件的监控技术， Apigee Edge 的部署指南

启用 JMX

对于 Cassandra 默认启用 JMX，对于所有其他 Edge 则默认停用 JMX 组件。因此，您必须分别为每个组件启用 JMX。

每个组件支持不同端口上的 JMX。下表列出了 JMX 端口和为在该端口启用 JMX 而修改的文件：

组件	JMX 端口	文件
管理服务器	1099	/opt/apigee/edge-management-server/bin/start
路由器	1100	/opt/apigee/edge-router/bin/start
消息处理器	1101	/opt/apigee/edge-message-processor/bin/start
Qpid	1102	/opt/apigee/edge-qpid-server/bin/start
Postgres	1103	/opt/apigee/edge-postgres-server/bin/start

例如，要在管理服务器上启用 JMX，请打开在编辑器中 /opt/apigee/edge-management-server/bin/start 。您应该会看到以下代码行启动管理服务器：

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts -Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path 
-Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

修改此行以添加以下内容：

-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

请注意，该行将管理服务器的 JMX 端口号指定为 1099。将每个组件的端口号（如上表定义）。例如：

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts 
-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false 
-Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path -Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

保存文件，然后重新启动该组件。例如，重启服务器：

> /opt/apigee/apigee-service/bin/ apigee-service edge-management-server restart

启用 JMX 身份验证和设置 JMX 密码

对管理服务器、消息处理器、Qpid 和 Postgres 的监控过程使用 JMX。JMX 默认处于启用状态，远程 JMX 访问不需要密码。

要启用 JMX 身份验证，每个组件都有一个 change_jmx_auth 操作，供您用于启用/停用身份验证和设置 JMX 凭据。

要启用 JMX 身份验证，请使用以下命令：

>  /opt/apigee/apigee-service/bin/apigee-service comp change_jmx_auth optionsOrConfigFile

其中：

comp 是 edge-management-server、Edge-message-processor、 Edge-qpid-server，或 edge-postgres-server.
具体选项包括： <ph type="x-smartling-placeholder">
- -u：用户名
- -p：密码
- -e：y（启用）或 n （可编辑）
配置文件包括： <ph type="x-smartling-placeholder">
- JMX_USERNAME=用户名
- JMX_ENABLED=y/n
- JMX_PASSWORD=password （如果未设置或未使用 -p 传入，系统会提示您）

例如，如需在命令行中使用选项，请执行以下命令：

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -u foo -p bar -e y

如果您有配置文件：

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -f configFile

如果您在多个节点上运行 Edge，请在所有节点上运行此命令，并指定相同的用户名和密码。

如果以后要停用 JMX 身份验证，请使用以下命令：

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -e n

管理服务器

使用用于监控系统健康检查和处理信息的 JConsole

使用 JConsole（一种兼容 JMX 的工具）来管理和监控健康检查和处理统计信息。通过使用 JConsole，您可以使用管理服务器（或任何服务器）公开的 JMX 统计信息，并且在图形界面中显示它们。如需详细了解 JConsole 的用法，请参阅 http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html。

使用 JConsole 和以下服务网址监控 JMX 属性 (MBean) 通过 JMX 提供。

service:jmx:rmi:///jndi/rmi://<ip address>:<port>/jmxrmi

其中，<ip address> 是管理服务器的 IP 地址（或者相应的服务器）。默认情况下，管理服务器的端口为 1099。

下表显示了常规 JMX 统计信息：

JMX MBean	JMX 属性
内存	HeapMemoryUsage
	NonHeapMemoryUsage
	用法
注意：属性值将以四个值显示：submitted、 init、max 和 used。

使用 Edge Application API 检查

可通过调用以下代码，对管理服务器（或任何服务器）执行 API 检查 C网址命令：

curl http://<host>:8080/v1/servers/self/up -H "Accept: application/json"

其中，<host> 是管理服务器的 IP 地址。您可以将 Accept 类型指定为 application/json 或 application/xml。

此调用会返回“true”和“false”。如果为 true，则表示节点已启动，Java 服务已启动。

如果未收到 HTTP 200 (OK) 响应，则 Edge 无法响应端口 8080 请求。

问题排查

登录服务器并运行以下命令：
/opt/apigee/apigee-service/bin/apigee-service 边缘管理服务器状态
如果服务未运行，请启动服务：
/opt/apigee/apigee-service/bin/apigee-service 边缘管理服务器启动

使用 Edge 应用 - 用户、组织和部署检查

管理服务器发挥着至关重要的作用，能够将各个本地的所有其他包裹汇集在一起安装。您可以在管理服务器上查看用户、组织和部署状态方法是发出以下命令：

curl -u userEmail:password http://localhost:8080/v1/users
curl -u userEmail:password http://localhost:8080/v1/organizations
curl -u userEmail:password http://localhost:8080/v1/organizations/orgname/deployments

系统应显示“已部署”状态。如果这些方法都失败，请以下：

检查管理服务器日志（位于 opt/apigee/var/log/edge-management-server）检查是否存在任何错误
对管理服务器进行调用以检查其是否正常运行正确。
从 ELB 中移除服务器，然后重启管理服务器。
/opt/apigee/apigee-service/bin/apigee-service 边缘管理服务器重启

路由器

您可以通过调用以下 C网址对路由器（或任何服务器）执行 API 检查命令：

curl http://<host>:8081/v1/servers/self/up

其中，host 是路由器的 IP 地址。

此调用会返回“true”和“false”。如果为 true，则表示该节点已启动且路由器服务正在运行。

如果未收到 HTTP 200 (OK) 响应，则 Edge 无法响应端口 8081 请求。

问题排查

登录服务器并运行以下命令：
/<inst_root>/apigee/apigee-service/bin/apigee-service 边缘路由器状态
如果服务未运行，请启动服务
/<inst_root>/apigee/apigee-service/bin/apigee-service 边缘路由器启动
重启后，请检查它能否正常运行
curl -v http://localhost:port/v1/servers/self/up

其中，路由器的 port 为 8081，消息处理器的端口为 8082。

使用用于监控系统健康检查和处理信息的 JConsole

对于管理服务器，请按照上述相同方法操作。

注意：请务必使用 1100 端口。

消息处理器

使用用于监控系统健康检查和处理信息的 JConsole

对于管理服务器，请按照上述相同方法操作。

注意：请务必使用端口 - 1101。

使用 Edge Application API 检查

对于路由器，请按照上述相同步骤操作。

注意：请务必使用 8082 端口。

使用 JMX 消息流检查

对于管理服务器，请按照上述相同方法操作。

注意：请务必使用端口 - 1101。

Qpid 服务器

使用 JConsole 监控系统健康检查和处理信息

对于管理服务器，请按照上述相同方法操作。

注意：请务必使用 1102 端口。

使用 Edge Application API 检查

对于管理服务器，请按照上述相同方法操作。

注意：请务必使用 8083 端口。以下 C网址命令是 Qpid Server：

curl http://<qpid_IP>:8083/v1/servers/self

Postgres 服务器

使用用于监控系统健康检查和处理信息的 JConsole

对于管理服务器，请按照上述相同方法操作。

注意：请务必使用端口 - 1103。

使用 Edge Application API 检查

对于管理服务器，请按照上述相同方法操作。

注意：请务必使用 8084 端口。以下 C网址命令是 Postgres Server 支持：

curl http://<postgres_IP>:8084/v1/servers/self

使用 Edge 应用组织和环境检查

您可以检查在 Postgres Server 上进行初始配置的组织和环境名称方法是发出以下 C网址命令：

curl http:// <postgres_IP>:8084/v1/servers/self/organizations

注意：请务必使用 8084 端口。

系统应显示组织和环境名称。

使用 Edge 应用 axstatus 勾选

您可以通过发出以下 C网址来验证分析服务器的状态命令。

curl -u userEmail:password http://<host>:<port>/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus

对于所有分析服务器，系统应显示 SUCCESS 状态。上述 C网址的输出如下所示：

{
  "environments" : [ {
    "components" : [ {
      "message" : "success at Thu Feb 28 10:27:38 CET 2013",
      "name" : "pg",
      "status" : "SUCCESS",
      "uuid" : "[c678d16c-7990-4a5a-ae19-a99f925fcb93]"
     }, {
      "message" : "success at Thu Feb 28 10:29:03 CET 2013",
      "name" : "qs",
      "status" : "SUCCESS",
      "uuid" : "[ee9f0db7-a9d3-4d21-96c5-1a15b0bf0adf]"
     } ],
    "message" : "",
    "name" : "prod"
   } ],
  "organization" : "acme",
  "status" : "SUCCESS"
}

PostgreSQL 数据库

使用 check_postgres.pl 脚本

要监控 PostgreSQL 数据库，您可以使用标准监控脚本 check_postgres.pl，可从以下网址获取： http://bucardo.org/wiki/Check_postgres.

注意：您需要在每个 Postgres 中安装脚本 check_postgres.pl 节点。

在运行脚本之前，请执行以下操作：

确保您已安装 perl-Time-HiRes.x86_64，这是一个 Perl 模块，实现高分辨率闹钟、休眠、gettimeofday 和间隔计时器。例如，您可以使用以下命令进行安装：
yum 安装 perl-Time-HiRes.x86_64

使用脚本 check_postgres.pl 进行的 API 调用的默认输出与 Nagios 兼容。更新后安装脚本后，进行以下检查：

数据库大小 - 检查数据库大小：
check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -include=apigee -action database_size --warning='800 GB' --active='900 GB'
到数据库的传入连接 - 检查到的传入连接数数据库，并与允许的最大连接数进行比较：
check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -操作后端
数据库可用性和性能 – 检查数据库是否正在运行可用：
check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -操作连接
磁盘空间 - 检查磁盘空间：
check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -actiondisk_space --warning='80%' --referrer='90%'
初始配置的组织/环境 - 检查组织数量和 Postgres 节点中初始加入的环境：
check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action=custom_query --query="select count(*) 的结果来自 pg_tables，其中 schemaname='analytics'以及类似“%fact”的表名称--warning='80' --referrer='90'--valtype=integer

注意：请参阅 http://bucardo.org/check_postgres/check_postgres.pl.html ，如果您需要有关使用上述命令的任何帮助。

数据库检查

您可以验证是否在 PostgreSQL 数据库中创建了正确的表。登录 PostgreSQL 数据库：

psql  -h /opt/apigee/var/run/apigee-postgresql/  -U apigee -d apigee

然后运行以下命令：

\d analytics."<org>.<env>.fact"

检查 postgres 的健康状况进程

您可以通过调用以下 C网址命令在 postgres 机器上执行 API 检查：

http://<postgres_IP>:8084/v1/servers/self/health/

注意：请务必使用端口 8084。

当 postgres 进程处于活动状态时，它会返回“ACTIVE”状态。如果 postgres 如果进程未启动并运行，则会返回“INACTIVE”状态。

Postgres 资源

Apache Cassandra

使用 JConsole - 监控任务统计信息

使用 JConsole 和以下服务网址监控 JMX 属性 (MBean) 通过 JMX 提供。

service:jmx:rmi:///jndi/rmi://<ip address>:7199/jmxrmi

其中 <ip address> 是 Cassandra 的 IP 服务器。

对 Cassandra 默认启用 JMX，对 Cassandra 的远程 JMX 访问不需要密码。

要启用 JMX 身份验证以添加密码，请执行以下操作：

修改 /opt/apigee/customer/application/cassandra.properties。如果该文件不存在，请创建该文件。
将以下内容添加到文件中：
conf_cassandra-env_com.sun.management.jmxremote.authenticate=true
保存文件。
将以下文件从 $JAVA_HOME 目录复制到 /opt/apigee/data/apigee-cassandra/:
cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/data/apigee-cassandra/jmxremote.password

cp ${JAVA_HOME}/lib/management/jmxremote.access $APIGEE_ROOT/data/apigee-cassandra/jmxremote.access
修改 jmxremote.password 和将用户名和密码添加到该文件中：
Cassandra 密码

其中，password 是 JMX 密码。
修改 jmxremote.access 和添加以下角色：
Cassandra 读写
确保文件归“apigee”所有文件模式为 400：
>chown apigee:apigee /opt/apigee/data/apigee-cassandra/jmxremote.*
>chmod 400 /opt/apigee/data/apigee-cassandra/jmxremote。*
在以下设备上运行 configure Cassandra：
> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra 配置
重启 Cassandra：
> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra 重启
在所有其他 Cassandra 节点上重复此过程。

如需稍后停用身份验证，请执行以下操作：

修改 /opt/apigee/customer/application/cassandra.properties。
移除文件中的以下行：
conf_cassandra-env_com.sun.management.jmxremote.authenticate=true
在 Cassandra 上运行配置：
> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra 配置
重启 Cassandra：
> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra 重启
在所有其他 Cassandra 节点上重复此过程。

Cassandra JMX 统计信息

JMX MBean	JMX 属性
ColumnFamilies/apprepo/environments ColumnFamilies/apprepo/organizations ColumnFamilies/apprepo/apiproxy_revisions ColumnFamilies/apprepo/apiproxies ColumnFamilies/audit/audits ColumnFamilies/audit/audits_ref	PendingTasks
	MemtableColumnsCount
	MemtableDataSize
	ReadCount
	RecentReadLatencyMicros
	TotalReadLatencyMicros
	WriteCount
	RecentWriteLatencyMicros
	TotalWriteLatencyMicros
	TotalDiskSpaceUsed
	LiveDiskSpaceUsed
	LiveSSTableCount
	BloomFilterFalsePositives
	RecentBloomFilterFalseRatio
	BloomFilterFalseRatio

使用 nodetool 实用程序管理集群节点

nodetool 实用程序是 Cassandra 的命令行界面，用于管理集群节点该实用程序位于 opt/apigee/apigee-cassandra/bin。

如需详细了解 nodetool 实用程序，请参阅 http://www.datastax.com/docs/1.0/references/nodetool。

可以在所有 Cassandra 集群节点上进行以下调用：

常规环信息（也适用于单个 Cassandra 节点）：查找 “向上”和“Normal”（正常）所有节点
[host]# nodetool -h localhost 响铃

上述命令的输出如下所示：
地址 DC 机架状态状态负荷令牌
192.168.124.201 dc1 ra1 正常大小 1.67 MB 33.33%
192.168.124.202 dc1 ra1 正常大小 1.68 MB 33.33% 56713727820156410577229101238628035242
192.168.124.203 dc1 ra1 正常大小 1.67 MB 33.33% 113427455640312821154458202477256070484
关于节点的一般信息（每个节点的调用次数）
nodetool -h localhost 信息

上述命令的输出如下所示：
令牌：0
八卦消息： true
加载大小：1.67 MB
世代编号：1361968765
正常运行时间（秒）：78108
堆内存 (MB)：46,80 / 772,00
数据中心：dc1
机架：ra1
异常：0
旧货服务器的状态（服务客户端 API）
host]# nodetool -h localhost statusthrift

上述命令的输出将状态显示为“running”。
数据流操作的状态：观察 cassandra 的流量节点
nodetool -h localhost netstats 192.168.124.203

上述命令的输出如下所示：
模式：NORMAL
没有流式传输到 /192.168.124.203
的内容没有来自 /192.168.124.203
的流式传输内容池名称处于活跃、待处理状态
命令无 0 1688 年
回复不适用 0 292277

Cassandra 监控（界面）

请访问 datastax opscenter 网址：http://www.datastax.com/products/opscenter。

Cassandra 资源

请参阅以下网址：http://www.datastax.com/docs/1.0/operations/monitoring。

Apache ZooKeeper

检查 ZooKeeper 状态

确保 ZooKeeper 进程正在运行。ZooKeeper 会写入一个 PID 文件到 opt/apigee/var/run/apigee-zookeeper/apigee-zookeeper.pid。
测试 ZooKeeper 端口，确保您可以与端口 2181 和端口 2181 建立 TCP 连接 3888。
确保您可以从 ZooKeeper 数据库中读取值。使用 ZooKeeper 连接客户端库（或 /opt/apigee/apigee-zookeeper/bin/zkCli.sh）并从数据库中读取值。
查看状态：
> /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper 状态

使用 ZooKeeper Four Letter Words

可以通过发送到使用 netcat (nc) 或 telnet 访问端口 2181。

如需详细了解 ZooKeeper 命令，请参阅：http://zookeeper.apache.org/doc/r3.1.2/zookeeperAdmin.html#sc_zkCommands。

例如：

srvr：列出完整详细信息。
stat：列出简要详情服务器和连接的客户端

您可以发出以下命令到 ZooKeeper 端口：

运行由四个字母组成的 ruok 命令，测试服务器是否以无错误状态运行。答成功响应会返回“imok”。
echo ruok |nc <主机> 2181

返回：
Imok
运行由四个字母组成的命令 stat 列出服务器性能和已连接的客户端统计信息。
echo 统计信息 |nc <主机> 2181

返回：
Zookeeper 版本：3.4.5-1392090、构建于 2012 年 9 月 30 日 17:52 (GMT)
客户：
/0:0:0:0:0:0:0:1:33467[0](queued=0,recved=1,sent=0)
/192.168.124.201:42388[1](queued=0,recved=8433,sent=8433)
/192.168.124.202:42185[1](queued=0,recved=1339,sent=1347)
/192.168.124.204:39296[1](queued=0,recved=7688,sent=7692)
延迟时间（最小值/平均值/最大值）：0/0/128
接收时间：26144
已发送：26160
连接：4
未完成：0
Zxid：0x2000002c2
模式：关注者
节点数：283
注意：有时，需要查看 ZooKeeper 是否处于 Mode：leader、关注者或观察者。
如果 netcat (nc) 不可用，您可以使用 Python 作为替代方案。创建文件名为 zookeeper.py 包含以下内容：
导入时间、套接字，
sys c = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
c.connect((sys.argv[1], 2181))
c.send(sys.argv[2])
time.sleep(0.1)
打印 c.recv(512)

现在，运行以下 Python 代码行：
python zookeeper.py 192.168.124.201 鲁克
python zookeeper.py 192.168.124.201 stat

OpenLDAP

LDAP 级别测试

您可以监控 OpenLDAP，以查看特定请求是否得到正确处理。在也就是检查特定搜索会返回正确结果。

使用 ldapsearch （yum 安装 openldap-clients）来查询系统管理员条目。此条目用于对所有 API 调用进行身份验证。
ldapsearch -b "uid=admin,ou=users,ou=global,dc=apigee,dc=com"-x -W -D "cn=manager,dc=apigee,dc=com"- 小时 ldap://localhost:10389 -LLL

然后，系统会提示您输入 LDAP 管理员密码：
输入 LDAP 密码：

输入密码后，您会看到以下形式的回复：
dn: uid=admin,ou=users,ou=global,dc=apigee,dc=com
objectClass：organizationPerson
objectClass：person
objectClass：inetOrgPerson
objectClass：top
uid：admin
cn：管理员
sn：管理员
用户密码：e1NTSEF9bS9xbS9RbVNXSFFtUWVsU1F0c3BGL3BQMkhObFp2eDFKUytmZVE9PQ=
=
邮寄地址：opdk@google.com
检查管理服务器是否仍连接到 LDAP 问题：
curl -u <userEMail>:<密码>http://localhost:8080/v1/users/<ADMIN>

返回：
{
"emailId"：<ADMIN>，
“firstName”: "管理员",
“lastName”：“管理员”
}

您还可以监控 OpenLDAP 缓存，以帮助减少磁盘访问次数从而提升系统性能。监控并调整 OpenLDAP 服务器会严重影响目录服务器的性能。您可以查看文件 (opt/apigee/var/log) 复制到获取有关缓存的信息。

如何监控

启用 JMX

启用 JMX 身份验证和 设置 JMX 密码

管理服务器

使用 用于监控系统健康检查和处理信息的 JConsole

使用 Edge Application API 检查

问题排查

使用 Edge 应用 - 用户、组织和部署检查

路由器

问题排查

使用 用于监控系统健康检查和处理信息的 JConsole

消息处理器

使用 用于监控系统健康检查和处理信息的 JConsole

使用 Edge Application API 检查

使用 JMX 消息流检查

Qpid 服务器

使用 JConsole 监控系统健康检查和处理信息

使用 Edge Application API 检查

Postgres 服务器

使用 用于监控系统健康检查和处理信息的 JConsole

使用 Edge Application API 检查

使用 Edge 应用组织和环境检查

使用 Edge 应用 axstatus 勾选

PostgreSQL 数据库

使用 check_postgres.pl 脚本

数据库检查

检查 postgres 的健康状况 进程

Postgres 资源

Apache Cassandra

使用 JConsole - 监控任务 统计信息

Cassandra JMX 统计信息

使用 nodetool 实用程序 管理集群节点

Cassandra 监控（界面）

Cassandra 资源

Apache ZooKeeper

检查 ZooKeeper 状态

使用 ZooKeeper Four Letter Words

OpenLDAP

LDAP 级别测试

启用 JMX 身份验证和设置 JMX 密码

使用用于监控系统健康检查和处理信息的 JConsole

使用用于监控系统健康检查和处理信息的 JConsole

使用用于监控系统健康检查和处理信息的 JConsole

使用用于监控系统健康检查和处理信息的 JConsole

检查 postgres 的健康状况进程

使用 JConsole - 监控任务统计信息

使用 nodetool 实用程序管理集群节点