SuperAPI AI 工具集

dt-obs-extensions

部署与运维

查看项目

更新于 11-02 22:49

技能介绍

用途:本技能面向 Dynatrace 扩展的运维检查与故障排查,帮助确认已安装扩展及其监控配置(Monitoring Configuration)的状态,定位扩展报错原因。资料说明,扩展安装后会带来仪表板、告警模板、OpenPipeline 规则等资产;每个扩展可以创建多个监控配置,这些配置可运行在 ActiveGate 或 OneAgent 上,并可独立启用或禁用,每个配置有各自状态,可通过本技能查询。

主要能力:一是查询扩展状态。可用 DQL:timeseries count(dt.sfm.extension.config.status), by: {dt.extension.name, dt.extension.config.id, dt.extension.status},其中 dt.extension.name 为扩展名,dt.extension.config.id 为监控配置 ID,dt.extension.status 为当前状态值。二是获取扩展事件日志:当状态不是 OK 时,使用 fetch dt.system.events | filter dt.extension.name == "<extension_name>" AND dt.extension.config.id == "<config_id>",在 content 字段中查找 DEC:[A-Z0-9_]+ 格式的错误码,再到 references/extensions-error-codes.md 中检索对应错误码的含义与修复建议。三是提供状态对照表,覆盖 OK、STARTUP/STARTUP_PENDING/STARTUP_SCHEDULED、RESTART/TIMED_OUT_RESTART、IDLE、WARNING、GENERIC_ERROR、STARTUP_ERROR、HIGH_CPU/HIGH_CPU_RESTART、HIGH_MEMORY/HIGH_MEMORY_RESTART、EEC_HARD_LIMIT_REJECTION/EEC_HARD_LIMIT_RESTART、EEC_RESTSERVER_ERROR、EXTENSIONS_CACHE_ERROR、EXTENSION_VERIFICATION_ERROR、CUSTOM_CODE_EXTENSION_NOT_ALLOWED、INCOMPATIBLE_API_ERROR、MAX_TASKS_LIMIT_REJECTION、MISSING_BINARY/MISSING_DATASOURCE、GROUP_NAME_CHANGE 等,并给出等待、检查日志、切换 ActiveGate 性能配置、检查端口冲突、检查磁盘空间、校验 extension.yaml、更新 ActiveGate/OneAgent、增加 ActiveGate 或拆分分组、重装、等待再平衡等建议。

使用方式:遇到扩展状态非 OK 时,先运行状态查询确定具体状态码,再查状态对照表;如仍不明确,则拉取该扩展的事件日志;日志中出现 DEC 错误码时,在 references/extensions-error-codes.md 中搜索对应标题并读取后续约 50 行,读到下一个 ## Error Code 标题为止,资料明确不建议加载整份大文件。扩展反复重启时,检查是否为 HIGH_CPU_RESTART、HIGH_MEMORY_RESTART 或 TIMED_OUT_RESTART,并考虑切换更高的 Performance Profile 或审查配置范围。扩展不产生数据时,确认状态为 OK 而非 IDLE 或错误状态、监控配置已启用,并验证到被监控系统的网络连通性。

适用场景:检查扩展监控配置状态、诊断扩展启动或运行错误、分析扩展重启与资源问题、排查扩展无数据等情况。

限制:资料以 DQL 查询和状态/错误码参考为核心,未提供扩展安装流程、配置创建步骤、权限要求、支持版本范围或价格信息;具体错误码修复建议需查阅对应参考文件。