平台分析健康检查实用程序

平台分析健康检查实用程序是一种端到端的健康检查。该实用程序可解决生成、使用和报告平台遥测所需的多个组件的问题。特别是，如果您的某个项目中的报告未向 Platform Analytics 仓库提供遥测数据，则建议进行此检查。

平台分析健康检查实用程序执行以下所有三项健康检查：启动运行状况检查以及端到端遥测检查，以验证数据是否可以由智能服务器生成并由平台分析消费者（遥测存储）使用。

如果您使用的是 Linux，则 Platform Analytics 健康检查实用程序位于 /opt/MicroStrategy/PlatformAnalytics/bin。如果你使用的是 Windows，它位于 C:\Program Files (x86)\MicroStrategy\Platform Analytics\bin。

如何运行 Platform Analytics 健康检查实用程序

要执行端到端 Platform Analytics 健康检查，请运行 platform-analytics-health-check.(sh/bat) 公用事业。

平台分析健康检查实用程序执行的端到端遥测检查包括：

健康检查
Redis 运行状况检查
Kafka 运行状况检查
变更日志健康检查
统计健康检查

健康检查

在健康检查期间，将执行两项检查：

消费者/生产者是否可以连接到安装期间提供的并存储在 PAConsumerConfig.yaml 配置文件？如果没有，则进行额外的网络连接测试来诊断问题的原因。
数据库用户是否具有所需的权限？有关安装先决条件的完整列表，请参阅 Platform Analytics 先决条件。

健康检查报告提供了权限和结果状态的列表。如果所有检查都成功，最后一行将显示 Warehouse health check result is healthy。

如果任何一行内容为 Failed，检查你的 PAConsumerConfig.yaml 文件并确保数据库具有正确的权限。

健康检查错误故障排除建议

如果您在健康检查中收到以下任何错误，请参考以下建议的解决方法：

“缺失权限”错误

如果数据库用户存储在 PAConsumerConfig.yaml 配置文件缺少权限，则 INFO [privilege type] privilege: Failed。要解决此错误，管理员必须将缺失的权限授予数据库用户并重新启动使用者。

如何授予缺失的权限：

停止 Platform Analytics Consumer 和 Usher Metadata Producer。
连接到包含平台分析存储库的数据库服务器。执行以下命令，将“someuser”和“somehost”替换为客户指定的信息：
复制
```
GRANT DROP ON platform_analytics_wh.* TO ‘someuser’@‘somehost’;
```
重新启动 Platform Analytics Consumer 和 Usher Metadata Producer。

连接失败错误

如果消费者或生产者无法使用 PAConsumerConfig.yaml 配置文件，您可能会看到以下错误：

复制

2018-11-21 21:43:28,793 INFO HealthCheck main - Failed to connect to the database. Retrying after waiting for 60 seconds.
2018-11-21 21:45:31,797 INFO HealthCheck main - Failed to connect to the database. Retrying after waiting for 60 seconds.
2018-11-21 21:47:34,800 ERROR HealthCheck main - Failed to connect to the database using url:jdbc:mysql://XX.Y.Z.1:3306/platform_analytics_wh?rewriteBatchedStatements=true&useLegacyDatetimeCode=false&serverTimezone=UTC. Please double check your connection parameters.
Communications link failure

选择 PAConsumerConfig.yaml 文件根据安装期间提供的数据库信息填充。要解决此错误，请连接到托管 Platform Analytics 的计算机并确认 warehouseDbConnection 标题正确 PAConsumerConfig.yaml 文件。

“数据库用户密码错误”错误

如果加密仓库密码不正确，消费者或者生产者将无法连接数据库。要生成新的加密密码并更新确认，请参阅更新配置到 Platform Analytics 存储库的数据库用户密码。

“启用 SSL 情况下创建的数据库用户”错误

Platform Analytics 支持 MySQL 5.6、5.7 和 8.0 版本。对于 MySQL 8.0，默认情况下启用 SSL 连接。目前，Platform Analytics 不支持连接到 MySQL 的数据库用户使用 SSL。为 Platform Analytics Consumer 或 Usher Metadata Producer 创建数据库用户时，请使用 REQUIRE 条款。

停用 SSL 的方法：

连接到 Platform Analytics 存储库并执行以下命令：
复制
```
show variables like '%ssl%';
```
如果结果为 'have_ssl' 是 'YES' 那么 SSL 就启用了。使用以下方式创建用户 mysql_native_password 和 REQUIRE NONE 无需 SSL 即可连接的选项。
复制
```
CREATE USER 'test'@'%' IDENTIFIED WITH mysql_native_password BY 'password' REQUIRE NONE;
```

Redis 运行状况检查

Redis 运行状况检查确定使用者或生产者是否可以成功连接到 Redis 服务器。该检查提供有关在启动期间收集的 Redis 的详细统计信息。如果所有检查都成功，最后一行将显示 Redis server health check result is healthy。

如果您在检查中发现错误，请确保 Redis 正在运行，并且您的配置正确 PAConsumerConfig.yaml 文件。

Redis 健康检查故障排除建议错误

如果你在 Redis 中收到以下任何错误健康检查，这里是建议的解决方法：

“Redis已停止”错误

如果消费者或生产者无法连接到 Redis，则可能是因为 Redis 处于停止状态。要解决此错误，请启动 MicroStrategy In-Memory Cache、Platform Analytics Consumer 和 Usher Metadata Producer。

“连接 Redis 失败”错误

如果消费者或生产者无法连接到Redis，可能是因为配置不正确 PAConsumerConfig.yaml 文件。要解决此错误，请连接到托管 Platform Analytics 的计算机并确认 redisConnection 标题正确 PAConsumerConfig.yaml 文件。

Redis 服务器可能无法将快照写入磁盘。如果是这种情况，您可以禁用 Redis 服务器上的 RDP 快照过程。

停止 platform-analytics-usher-lookup-producer 使用以下命令：
复制
```
./platform-analytics-usher-lookup-producer.sh stop
```
停止 platform-analytics-consumer 使用以下命令：
复制
```
./platform-analytics-consumer.sh stop
```
停止 Redis 服务器。
将以下更改应用到 redis.conf 文件：
1. 注释掉下面的三行 ###SNAPSHOTTING### 标题。
  复制
```
#save 900 1
#save 300 10
#save 60 10000
```
2. 在同一部分中输入以下行：
  复制
```
save ""
```
启动 Redis 服务器。
启动 platform-analytics-consumer 使用以下命令：
复制
```
./platform-analytics-consumer.sh start
```
启动 platform-analytics-usher-lookup-producer 使用以下命令：
复制
```
./platform-analytics-usher-lookup-producer.sh start
```

为 Redis 启用密码验证错误

如果消费者或生产者无法连接到 Redis，可能是因为启用了密码身份验证。默认情况下，Redis 未配置密码验证，但可以在安装后进行设置。

如果 Redis 已启用密码验证，并且密码在 PAConsumerConfig.yaml 配置文件，消费者或生产者将无法连接到Redis。要解决此错误，请按照在 MicroStrategy Telemetry Cache 上启用密码身份验证中的步骤操作。

Kafka 运行状况检查

Kafka 健康检查确保遥测管理器（Apache Zookeeper）和遥测服务器（Kafka 服务器）已启动并连接。如果所有检查都成功，最后一行将显示 Kafka cluster health check result is healthy。

由于 Telemetry Server 依赖于 Telemetry Manager，因此必须首先启动 Telemetry Manager。

如果您在检查中看到错误，请确保已启动 ZooKeeper 和 Kafka。

Kafka 健康检查错误的建议故障排除

如何检查 ZooKeeper 服务器是否在所有节点上运行：

在 Linux 上，运行以下命令来运行 PID。

复制

ps ax | grep java | grep -i QuorumPeerMain | grep -v grep | awk '{print $1}'

在 Windows 上，打开 Windows 的服务并检查“Apache ZooKeeper”服务是否正在运行。

如何检查 Kafka 服务器是否在所有节点上运行：

在 Linux 上，运行以下命令来运行 PID。

复制

ps ax | grep -i 'server.prop'| grep java | grep -v grep | awk '{print $1}'

在 Windows 上，打开 Windows 的服务并检查“Apache Kafka”服务是否正在运行。

如何在所有节点上启动 ZooKeeper 和 Kafka：

在 Linux 上，在 Kafka 目录中运行以下命令：

复制

# Start Zookeeper on all nodes,
./zookeeper-server-start.sh -daemon ../config/zookeeper.properties
# Start Kafka on all nodes,
./kafka-server-start.sh -daemon ../config/server.properties

在 Windows 上，打开 Windows 的服务并启动 Apache ZooKeeper 和 Apache Kafka。

如果这是具有 ZooKeeper 和 Kafka 的多个节点的集群环境，则必须首先启动 ZooKeeper 的所有节点。

变更日志健康检查

变更日志检查可确保平台分析消费者的健康状况。对于此检查，您必须提供一个项目 GUID 和一个报告 GUID 来进行测试。要求您修改报告的描述，从而生成变更日志。测试验证 Intelligence Server Producer 是否将日志生成到 Mstr.PlatformAnalytics.ChangeJournal.CubesReportsDashboard Kafka 主题。然后，它测试日志是否被处理并写入 Platform Analytics 仓库表 lu_object。

如果在相应的 Kafka 主题和仓库中都找到了该记录，则最后一行将显示 Change Journal health check result is healthy。

如果在检查中发现错误，请确保 Intelligence 服务器中的 Platform Analytics 功能标志“消息服务”处于打开状态，并且 Intelligence 服务器中的“属性 Telemetry Server enabled”设置为 True。

更改日志健康检查错误的建议故障排除

验证 Intelligence Server 是否已配置为将遥测数据写入 Kafka

使用命令管理器连接到情报服务器。
要查看功能标志的状态，请运行以下命令：
复制
```
LIST ALL FEATURE FLAGS;
```
在结果中，验证平台分析的消息服务功能标志是在。如果功能标志是离开，运行以下命令将其打开：
复制
```
ALTER FEATURE FLAG "Messaging Service for Platform Analytics" ON;
```
要查看已启用遥测服务器属性，运行命令：
复制
```
LIST PROPERTIES FOR SERVER CONFIGURATION;
```
在结果中，验证已启用遥测服务器属性设置为真的。如果属性设置为错误的，执行以下命令：

替换 <kafka server IP> 使用您的 Kafka 服务器 IP 地址。
复制
```
'ALTER SERVER CONFIGURATION ENABLEMESSAGINGSERVICES TRUE CONFIGUREMESSAGINGSERVICES "bootstrap.servers: <kafka server IP>:9092/batch.num.messages:5000/queue.buffering.max.ms:2000";
```
重新启动情报服务器。

验证 Platform Analytics Consumer 是否正常运行

在 Linux 上：

导航到安装 Platform Analytics 的文件夹。
```
<安装>/PlatformAnalytics/bin
```
执行下列命令：
复制
```
./platform-analytics-consumer.sh status
```
使用以下命令启动或重新启动服务器：
复制
```
./platform-analytics-consumer.sh start
```

如果重新启动服务器不能解决问题，请检查以下日志 <Install>/PlatformAnalytics/log/platform-analytics-consumer.log 或联系 MicroStrategy 技术支持并附加文件夹 <Install>/PlatformAnalytics/log 针对你的情况。

在 Windows 上：

使用 services.msc 打开 Windows 服务。
启动或重新启动遥测存储。

统计健康检查

此健康检查可确保平台分析消费者可以处理报告统计数据。系统将提示您执行上次健康检查的报告。这会在主题 Mstr.PlatformAnalytics.IsReportStats 中生成一个日志。健康检查验证 Intelligence Server Producer 是否向 Kafka 生成了记录，并且该记录位于 Platform Analytics 仓库中。

如果在相应的 Kafka 主题和仓库中都找到了该记录，则最后一行将显示 Statistics health check result is healthy。

如果您在检查中发现错误，请确保项目启用了统计信息并且正确配置了消息服务。

统计健康检查错误的建议故障排除

验证项目是否已启用统计信息

使用命令管理器连接到情报服务器。
运行命令：

将 <项目名称> 替换为您的项目名称。
复制
```
LIST ALL PROPERTIES FOR PASTATISTICS IN PROJECT "<Project Name>";
```
在结果中，验证属性“基本统计”是否设置为真的。如果设置为错误的，运行以下命令：

将 <项目名称> 替换为您的项目名称。
复制
```
ALTER PASTATISTICS BASICSTATS ENABLED DETAILEDREPJOBS TRUE DETAILEDDOCJOBS TRUE JOBSQL TRUE COLUMNSTABLES TRUE IN PROJECT "<Project Name>";
```
重新启动情报服务器。

验证 Platform Analytics Consumer 是否正常运行

在 Linux 上：

导航到安装 Platform Analytics 的文件夹。
```
<安装>/PlatformAnalytics/bin
```
执行下列命令：
复制
```
./platform-analytics-consumer.sh status
```
使用以下命令启动或重新启动服务器：
复制
```
./platform-analytics-consumer.sh start
```

在 Windows 上：

使用 services.msc 打开 Windows 服务。
启动或重新启动遥测存储。