简介
本文档介绍如何使用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支持并添加详细信息(如错误消息、配置信息或相关日志),以帮助加快故障排除速度。
相关信息