目录

简介

先决条件

要求

使用的组件

背景信息

配置

配置

步骤 1：通过REST API创建自定义事件

步骤 2：过滤和监控自定义事件

步骤 3：配置警报：操作和策略

验证

故障排除

结论

需要进一步的帮助

相关信息

简介

本文档介绍如何使用REST API在AppDynamics中配置自定义事件并将其连接到运行状况规则以进行自动警报。

先决条件

- 访问AppDynamics SaaS或本地控制器实例

- 创建和管理事件、运行状况规则和策略的权限

- 控制器版本21.x或更高版本

- 已配置通知渠道（邮件、SMS或第三方集成）

- 基本了解REST API和AppDynamics用户界面

要求

开始之前，请确保满足以下要求：

- AppDynamics Controller版本21.x或更高版本（适用于最新的事件和警报功能）

- 为控制器启用REST API访问

- 为传送警报而配置的通知渠道（电子邮件、短信或集成）

使用的组件

- AppDynamics控制器

- AppDynamics代理

- 通知渠道

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

背景信息

在云原生架构日益动态化的当今世界，主动监控对于确保系统恢复力和缩短平均解决时间(MTTR)至关重要。 AppDynamics提供强大的可观测性功能，包括能够创建自定义事件和警报，帮助运营团队更快地检测异常并精确响应。

开箱即用的指标非常关键，但现代系统通常需要特定环境的可观测性。无论您是集成CI/CD管道、自定义自动化工具还是外部系统，将自定义事件注入到AppDynamics都可以确保：

- 跨系统和业务指标的统一可视性

- 应用特定异常的实时检测

- 通过自动化操作减少手动干预

有时，创建自定义事件来监控应用程序的特定方面很有意义。本文旨在指导您如何通过AppDynamics控制器中的REST API创建自定义事件，以及如何根据自定义事件设置警报。

配置

本节介绍在AppDynamics Controller中创建自定义事件和配置警报的逐步过程。

配置

步骤 1：通过REST API创建自定义事件

可以使用AppDynamics REST API生成自定义事件。这对于集成外部系统、自定义脚本、自动化框架或第三方工具非常有用：

API调用示例：

POST https://

/controller/rest/applications/

/events?severity=ERROR&summary=Application+Stopped&eventtype=CUSTOM&customeventtype=App_Stop&comment=Please_start_application

关键参数：

- 将<controller-url>和<application_id>替换为控制器详细信息。

- 所需参数：

- 严重性（信息、警告、错误）

- 摘要（简短说明）

- 事件类型（必须为CUSTOM）

- customeventtype（您的自定义事件类型标签）

- 注释（可选详细消息）

成功的请求会返回事件ID，确认创建

示例："已成功创建事件ID:550346816"

可视性提示：不要忘记在Events UI中启用Custom过滤器以查看注入的事件。

步骤 2：过滤和监控自定义事件

- 在控制器UI中，导航到事件部分。

- 使用Filter by Custom Events添加事件类型或属性。

- 您可以指定密钥/值对以进行更精细的过滤。

- 对AND逻辑使用All（所有属性必须匹配），对OR逻辑使用Any（至少一个属性匹配）

这样就可以针对整个应用程序中的注入事件进行跟踪和调查。

步骤 3：配置警报：操作和策略

操作:

- 指定触发自定义事件（例如发送电子邮件、短信或调用Webhook）时发生的操作：

策略：

- 创建新策略或编辑现有策略：

- 在策略中，配置自定义事件过滤器以匹配您定义的自定义事件。

- 在策略操作选项卡中，添加新操作并选择您创建的自定义操作：

- 保存警报：配置警报后，单击Save创建警报：

创建警报后，每当在控制器中生成与指定条件匹配的自定义事件时，该警报就会触发。

验证

- 通过REST API发布测试自定义事件：

- 在Events UI中确认可见性（检查过滤器）：

- 验证为自定义事件触发了操作：

- 通过配置的通知渠道验证传送：

故障排除

问题

故障排除步骤

事件不可见

- 确保在Events UI中启用自定义过滤器(Custom filter is enabled eventtype)

- 仔细检查API调用中的eventtype和customeventtype参数。

API错误

- 常见错误："未指定事件摘要。" 始终在您的请求中提供摘要

- 验证API调用中的身份验证和应用ID。

未触发警报

- 确认运行状况规则和策略配置正确。

- 检查通知通道设置（邮件/SMS服务器配置）。

自定义事件限制

- 控制器对自定义事件架构计数和事件大小具有限制。

- 如果过帐大卷或复杂的架构，请查看文档

结论

AppDynamics中的自定义事件和警报提供了丰富可观察性策略的强大方式。无论您是与CI/CD工具、外部服务集成，还是仅将可视性扩展到关键工作流程，这些功能都可以确保更快地检测和解决问题，以防问题影响用户。开始利用自定义可观察性智能，将监控从被动提升为预测型。

需要进一步的帮助

如果您遇到问题或遇到问题，请联系AppDynamics支持并添加详细信息（如错误消息、配置信息或相关日志），以帮助加快故障排除速度。

相关信息

- 监视事件

- 警报和响应