插件错误处理消息

Register with higher version / Higher version of plugin available（请使用更高版本注册 / 有可用的更高版本插件）

该插件使用现有的插件模板注册，即已有来自其他服务器的相似插件以更高版本注册。

检查同类型插件中已注册的最高版本，并将此插件更新为相同或更高的版本。
例如，假设服务器 A 和服务器 B 中分别存在版本 1 和版本 2 的插件实例。那么，若要将该插件的另一个实例添加到服务器 C，则插件脚本中指定的版本应为版本 2 或更高。

Connection error（连接错误）

无法建立连接。提供的凭据可能有误，或 URL 无法访问。

使用登录凭据手动执行插件，检查是否返回有效的 JSON 输出。同时，在浏览器中检查该 URL 是否可正常访问。然后重启服务器监控代理。

Execution error / Plugin Script Output is not in json format.（执行错误 / 插件脚本输出不是 JSON 格式）

由于 JSON 输出无效，插件执行失败。

检查脚本，确保脚本返回有效的 JSON 输出。您可以手动执行脚本，复制输出内容，然后使用此免费 JSON 格式化工具验证 JSON 输出。

**node not present（节点不存在）

无法连接到指定节点

检查所提及的节点是否存在

<Module not installed>（模块未安装）

所需的依赖模块未安装。

参阅设置步骤中的"先决条件"部分，安装相关依赖模块。然后重启服务器监控代理。
您也可以在此处找到一些常用插件的依赖模块。

Plugin file type not supported（不支持插件文件类型）

编写插件仅支持以下格式：

• Linux - Python、Shell
• Windows - VB、Batch、PowerShell、DLL

确保您的脚本支持上述格式

Plugin file not found / No such file or directory（未找到插件文件 / 无此类文件或目录）

文件夹为空，或插件文件名与文件夹名不匹配。

确保插件文件名与文件夹名称相同。同时，将包含相应插件文件的插件文件夹移至 Site24x7 插件目录。

Plugin execution timed out（插件执行超时）

插件脚本的运行时间超过了抛出异常前设定的最大时间。

增大脚本执行超时值。

操作步骤：
1. 在 Site24x7 Web 客户端中，导航至相应的插件监视器，单击汉堡菜单 ，然后选择编辑。
2. 将脚本执行超时值增大至 120 秒，然后单击保存。
3. 重启服务器监控代理。

Syntax error: end of file unexpected（语法错误：文件意外结束）

插件脚本存在代码结构不匹配或格式不正确的问题。

系统逐行执行代码，因此语法必须正确，引号（""）、括号()等格式的使用须规范。

检查脚本，确保脚本语法和格式正确。

No plugin versions available in DB（数据库中无可用的插件版本）

必填的 plugin_version 键缺失。

在插件脚本中更新 plugin_version 编号，这是必填字段。
首次安装插件时，将插件版本更新为默认值 1。如果插件脚本有任何更改，则以 1 为增量递增 plugin_version。注意，plugin_version 只能为整数，即 1、2、3 等。
以下是脚本中插件版本的示例：

{
"plugin_version" : 1,
"heartbeat_required" : true,
"cpu" : 42.7
}

<plugin name> Permission denied（插件名称 权限被拒绝）

插件脚本未能执行，因为该插件没有所需的权限。

1. 使用 ls -l 命令检查插件脚本的权限。
2. 如有需要，使用 chmod 命令修改权限。例如，若要为用户添加脚本的执行权限，使用：chmod u+x myscript.py。

Error message not configured（未配置错误消息）

错误消息未配置。

在插件脚本中，针对无法采集指标的情况，将异常作为错误进行捕获。

<ps1 plugin name> cannot be loaded because running scripts is disabled in this system（由于此系统上已禁用运行脚本，无法加载）

您系统上 PowerShell 的执行策略设置为限制脚本运行。

更新执行策略。

操作步骤：

1. 登录到您的服务器。
2. 以管理员身份运行 PowerShell 提示符并执行以下命令：
   Set-ExecutionPolicy unrestricted
3. 重启插件代理服务。

HTTP error（HTTP 错误）

HTTP 连接错误

请检查您的配置并重启服务器代理

HTTP Error 404

1. 插件文件中给出的统计 URL 可能不受支持。请确保您已按照我们帮助文档中的说明在插件配置文件中添加了相应条目。
2. 确保您在插件文件中复制的 URL 与您在插件配置文件中提供的 URL 相同
3. 确保您在启用统计数据时在插件配置文件中给出的端口未被占用

请在插件文件中提供正确的 URL

HTTP Error 401

1. 用户在插件配置文件中指定的用户名、密码或领域与插件文件中的对应值不匹配。
2. 领域的值，例如 Strictly\ Private，在插件文件中不需要转义，即如果配置文件中是 Strictly\ Private，则插件文件中应指定为 "Strictly Private"。
3. 如果配置文件有任何更改，需要重启相应的插件服务

请在插件文件中提供正确的身份验证参数

HTTP Error 403

1. 配置文件 "http.conf" 是特定于类型的。确保代理机器的 IP 地址在 "Allow from" 规则中。
2. 如果 Apache 无法满足所需请求，可能是由于某些附加设置阻止了我们的 Python 脚本（插件文件）与统计 URL 的交互。例如：Web 应用程序防火墙

请确保插件脚本有权限与统计 URL 进行交互

HTTP Error 302

所请求的资源暂时位于不同的 URI 下

检查配置并移除重定向

<urlopen error [Errno -2] Name or service not known>（URL 打开错误：名称或服务未知）

您在插件文件中添加的状态 URL 无效或未知

请检查插件文件中提供的统计 URL 是否有误。