@dynatrace-sdk/client-notification-v2

中文文档
2.5.0发布于 2026/07/29Apache-2.0TypeScriptESM + CJS近 30 天下载 1.4万

npm License

中文使用文档
文档目录50 节
  1. 安装
  2. 获得帮助
  3. 许可证
  4. 通知
  5. 创建事件通知
  6. 删除事件通知
  7. 获取终止通知
  8. 获取事件通知
  9. 补丁事件通知
  10. 更新事件通知
  11. 资源 通知
  12. 创建资源通知
  13. 删除资源
  14. 删除资源通知
  15. 获取资源
  16. 获得资源
  17. 类型
  18. 戴维斯EventConfig
  19. 戴维斯事件Name
  20. 戴维斯Event Trigger 图形
  21. 戴维斯问题类别
  22. 戴维斯问题组
  23. Davis Problem Trigger 图形
  24. 实体标签
  25. 错误
  26. 错误细节
  27. 信封错误
  28. 事件
  29. 信息输入
  30. 事件 通知请求
  31. 事件通知日期
  32. 事件查询
  33. 事件查询
  34. 修改信息
  35. 标签式通知列表
  36. 通知列表
  37. 资源
  38. 资源通知请求
  39. 事件调试器配置
  40. 数字
  41. 戴维斯事件Name 游戏
  42. 戴维斯EventTrigger 字体
  43. Davis Problem Probleg Problem 开放期限
  44. Davis Problem Trigger 图形化
  45. 实体标签游戏
  46. 事件查询
  47. 事件类型
  48. 维护窗口
  49. 触发
  50. 触发更新字段

@natrace-sdk/客户端-通知-v2

npm License

与通知服务API管理资源/事件通知.

安装

npm install @dynatrace-sdk/client-notification-v2

获得帮助

许可证

此 SDK 分布于 Apache 许可证,2.0版本,更多信息见LICENSE.

API 参考

最新版本SDK的API 完整参考文件也可在 Dynatrace 开发者。 。 。 .

通知

import { eventNotificationsClient } from '@dynatrace-sdk/client-notification-v2';

创建事件通知

通知 创建 Event Notification( 配置): 承诺 <事件> 翻译:

所需范围 : 通知:通知:写

参数

名称类型
配置. 身体*必须事件 通知请求

回返

返回类型状态代码说明
事件201 (韩语)

掷出

错误类型错误消息
信封错误
代码示例
import { eventNotificationsClient } from "@dynatrace-sdk/client-notification-v2";

const data =
  await eventNotificationsClient.createEventNotification({
    body: {
      resourceId: "...",
      notificationType: "...",
      triggerConfiguration: {
        type: "event",
        value: { query: "..." },
      },
    },
  });

删除事件通知

通知 Client.deleteEvention(配置):承诺<void>

所需范围 : 通知:通知:写

参数

名称类型说明
配置.id*必须字符串一个UUID字符串识别此自通知 .

回返

返回类型状态代码说明
无效204 (韩语)无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { eventNotificationsClient } from "@dynatrace-sdk/client-notification-v2";

const data =
  await eventNotificationsClient.deleteEventNotification({
    id: "...",
  });

获取终止通知

通知 Client.getEvention(配置):承诺 <事件> 翻译:

所需范围 : 通知:通知:已读

参数

名称类型说明
配置.id*必须字符串一个UUID字符串识别此自通知 .

回返

返回类型状态代码说明
事件200个

掷出

错误类型错误消息
信封错误
代码示例
import { eventNotificationsClient } from "@dynatrace-sdk/client-notification-v2";

const data =
  await eventNotificationsClient.getEventNotification({
    id: "...",
  });

获取事件通知

通知 Client.getEventions(配置):承诺 <标签式通知列表> 翻译:

所需范围 : 通知:通知:已读

参数

名称类型说明
配置. appId字符串与通知有关的申请id。 可选,默认是从请求头自动推断出. 仅与手动测试目的有关,通过斯瓦克.
配置.限制编号每页返回的结果数量.
配置. 通知Type字符串字符串,用于定义应用程序上下文中通知的类型。 允许在一个应用程序中区分多种类型的通知.
配置。 关闭编号初始指数用来返回结果.
配置. 顺序字符串命令结果时要使用哪个字段 .
配置。 拥有者字符串
配置. 资源Id字符串要通知的资源唯一标识符 。 用于确定在应用程序和用户通知类型中是否有已登记的资源通知.
配置. 搜索字符串一个搜索术语.

回返

返回类型状态代码说明
标签式通知列表200个

掷出

错误类型错误消息
信封错误
代码示例
import { eventNotificationsClient } from "@dynatrace-sdk/client-notification-v2";

const data =
  await eventNotificationsClient.getEventNotifications();

补丁事件通知

通知 Client.patchEvention(配置):承诺 <事件> 翻译:

所需范围 : 通知:通知:写

参数

名称类型说明
配置. 身体*必须事件通知日期
配置.id*必须字符串一个UUID字符串识别此自通知 .

回返

返回类型状态代码说明
事件200个

掷出

错误类型错误消息
信封错误
代码示例
import { eventNotificationsClient } from "@dynatrace-sdk/client-notification-v2";

const data =
  await eventNotificationsClient.patchEventNotification({
    id: "...",
    body: {
      triggerConfiguration: {
        type: "event",
        value: { query: "..." },
      },
    },
  });

更新事件通知

通知 Client.update Evention(配置):承诺 <事件> 翻译:

所需范围 : 通知:通知:写

参数

名称类型说明
配置. 身体*必须事件通知日期
配置.id*必须字符串一个UUID字符串识别此自通知 .

回返

返回类型状态代码说明
事件200个

掷出

错误类型错误消息
信封错误
代码示例
import { eventNotificationsClient } from "@dynatrace-sdk/client-notification-v2";

const data =
  await eventNotificationsClient.updateEventNotification({
    id: "...",
    body: {
      triggerConfiguration: {
        type: "event",
        value: { query: "..." },
      },
    },
  });

资源 通知

import { resourceNotificationsClient } from '@dynatrace-sdk/client-notification-v2';

创建资源通知

资源通知 创建资源通知( 配置): 承诺 <资源> 翻译:

所需范围 : 通知:通知:写

参数

名称类型
配置. 身体*必须资源通知请求

回返

返回类型状态代码说明
资源201 (韩语)

掷出

错误类型错误消息
信封错误
代码示例
import { resourceNotificationsClient } from "@dynatrace-sdk/client-notification-v2";

const data =
  await resourceNotificationsClient.createResourceNotification(
    {
      body: { notificationType: "...", resourceId: "..." },
    },
  );

删除资源

资源通知 Client.deleteResource 通知(配置):承诺<void>

所需范围 : 通知:通知:写

参数

名称类型说明
配置. appId字符串与通知有关的申请id。 可选,默认是从请求头自动推断出. 仅与手动测试目的有关,通过斯瓦克.
配置.id*必须字符串定义此资源通知的UUID字符串 .

回返

返回类型状态代码说明
无效204 (韩语)无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { resourceNotificationsClient } from "@dynatrace-sdk/client-notification-v2";

const data =
  await resourceNotificationsClient.deleteResourceNotification(
    { id: "..." },
  );

删除资源通知

资源通知 Client.deleteResource 通知 ByTypeAndResource(配置):承诺<void>

所需范围 : 通知:通知:写

参数

名称类型说明
配置. appId字符串与通知有关的申请id。 可选,默认是从请求头自动推断出. 仅与手动测试目的有关,通过斯瓦克.
配置. 通知Type*必须字符串字符串,用于定义应用程序上下文中通知的类型。 允许在一个应用程序中区分多种类型的通知.
配置. 资源Id*必须字符串要通知的资源唯一标识符 。 用于确定在应用程序和用户通知类型中是否有已登记的资源通知.

回返

返回类型状态代码说明
无效204 (韩语)无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { resourceNotificationsClient } from "@dynatrace-sdk/client-notification-v2";

const data =
  await resourceNotificationsClient.deleteResourceNotificationByTypeAndResource(
    { notificationType: "...", resourceId: "..." },
  );

获取资源

资源通知( 配置): 承诺 <资源> 翻译:

所需范围 : 通知:通知:已读

参数

名称类型说明
配置. appId字符串与通知有关的申请id。 可选,默认是从请求头自动推断出. 仅与手动测试目的有关,通过斯瓦克.
配置.id*必须字符串定义此资源通知的UUID字符串 .

回返

返回类型状态代码说明
资源200个

掷出

错误类型错误消息
信封错误
代码示例
import { resourceNotificationsClient } from "@dynatrace-sdk/client-notification-v2";

const data =
  await resourceNotificationsClient.getResourceNotification(
    { id: "..." },
  );

获得资源

资源通知( 配置): 承诺 <通知列表> 翻译:

所需范围 : 通知:通知:已读

参数

名称类型说明
配置. appId字符串与通知有关的申请id。 可选,默认是从请求头自动推断出. 仅与手动测试目的有关,通过斯瓦克.
配置.限制编号每页返回的结果数量.
配置. 通知Type字符串字符串,用于定义应用程序上下文中通知的类型。 允许在一个应用程序中区分多种类型的通知.
配置。 关闭编号初始指数用来返回结果.
配置. 顺序字符串命令结果时要使用哪个字段 .
配置. 资源Id字符串要通知的资源唯一标识符 。 用于确定在应用程序和用户通知类型中是否有已登记的资源通知.
配置. 搜索字符串一个搜索术语.

回返

返回类型状态代码说明
通知列表200个

掷出

错误类型错误消息
信封错误
代码示例
import { resourceNotificationsClient } from "@dynatrace-sdk/client-notification-v2";

const data =
  await resourceNotificationsClient.getResourceNotifications();

类型

戴维斯EventConfig

名称类型说明
自定义过滤器无效 字符串额外的 DQL 匹配器表达式以进一步过滤事件以匹配. 默认 : ""
实体标签无效 实体标签
实体标签游戏无效的"所有""任何"
维护Window Trigger行为"总是" "里面" "外面"默认 : "always"
名称无效QQ阵列 <戴维斯事件Name> 翻译:
问题关闭被否决布尔Davis事件的触发器只开放或关闭。 已贬值的 - 使用触发 On 代替 . 默认 : false
触发"打开" "打开" "关闭" "关闭"要启动事件状态 。 "开放"(只活动),"开放"和"关闭"(两个阶段),或"关闭"(只关闭). 当未设定时, 返回到 ProblemClose 上, 以进行后向相容性 .
类型被否决无效QQ阵列 <字符串> 翻译:

戴维斯事件Name

名称类型说明
匹配*必须"等分" =========================================================================================================== (========================= (================================================ (==================Davis 事件名称必须等于或包含提供的字符串 .
名称*必须字符串

戴维斯Event Trigger 图形

名称类型
类型*必须"达维斯事件"
价值*必须戴维斯EventConfig

戴维斯问题类别

名称类型默认
可用性布尔false
自定义布尔false
错误布尔false
资讯布尔false
无法使用布尔false
资源布尔false
减速布尔false

戴维斯问题组

名称类型说明
准备布尔仅在第一个根源分析完成后运行 . 默认 : false
类别*必须戴维斯问题类别
自定义过滤器无效 字符串额外的 DQL 匹配器表达式以进一步过滤事件以匹配. 默认 : ""
实体标签无效 实体标签
实体标签游戏无效的"所有""任何"
问题关闭被否决布尔戴维斯问题的触发器只打开或关闭。 已贬值的 - 使用触发 On 代替 . 默认 : false
问题打开时间无效 5,10,15,30,60,120,240,1440,10080最小问题持续时间在起火前几分钟.
严重性 阈值无效 编号触发只针对其严重程度为这一价值或更严重的问题。 人数较少更严重(1=临界,5=信息),因此有3个匹配断裂 1,2和3.
触发"打开" "打开" "关闭" "关闭"问题状态启动。 "开放"(只活动),"开放"和"关闭"(两个阶段),或"关闭"(只关闭). 当未设定时, 返回到 ProblemClose 上, 以进行后向相容性 .
更新字段时触发Array <'dt.davis. 被影响的 用户 计数'\"dt.davis. 被影响的 级别"\"活动. 类别"\"活动. 严重"\"根-因为 实体 id"\"智能scape.被影响的 实体"跟踪值变化的问题事件字段 。 任何选定字段的更改都会导致再触发 .

Davis Problem Trigger 图形

名称类型
类型*必须"大问题"
价值*必须戴维斯问题组

实体标签

按键和(可选)值匹配的实体标记 。 例如{"foo": [],"bar": ["a","b","c"]

类型: 记录 < 字符串, 字符串 {} > 字符串

错误

名称类型
代码*必须编号
细节错误细节
消息*必须字符串

错误细节

名称类型
错误代码字符串
引用错误字符串

信封错误

名称类型
错误*必须错误

事件

名称类型说明
应用字符串注册通知的应用代号。 可选,默认是从请求中自动推断出来的。 仅与手动测试目的有关,通过斯瓦克.
编号*必须字符串
投入信息输入输入对象由主题和内容组成. 支持自动化表达式 https://dt-url.net/workflows-expression-reference 页面存档备份,存于互联网档案馆 和马克下语法。 附带一个app({ notification type}. notification-template.json)的模板将优先于这里提供的输入.
修改 资讯*必须修改信息
通知类型*必须字符串字符串,用于定义应用程序上下文中通知的类型。 允许在一个应用程序中区分多种类型的通知.
拥有者*必须字符串
资源索引*必须字符串要通知的资源唯一标识符 。 用于确定在应用程序和用户通知类型中是否有已登记的资源通知.
标题字符串
触发配置*必须事件调试器配置

信息输入

名称类型
内容无效 字符串
主题无效 字符串

事件 通知请求

名称类型说明
应用字符串注册通知的应用代号。 可选,默认是从请求中自动推断出来的。 仅与手动测试目的有关,通过斯瓦克.
编号字符串
投入信息输入输入对象由主题和内容组成. 支持自动化表达式 https://dt-url.net/workflows-expression-reference 页面存档备份,存于互联网档案馆 和马克下语法。 附带一个app({ notification type}. notification-template.json)的模板将优先于这里提供的输入.
通知类型*必须字符串字符串,用于定义应用程序上下文中通知的类型。 允许在一个应用程序中区分多种类型的通知.
资源索引*必须字符串要通知的资源唯一标识符 。 用于确定在应用程序和用户通知类型中是否有已登记的资源通知.
标题字符串
触发配置*必须事件调试器配置

事件通知日期

名称类型说明
应用字符串注册通知的应用代号。 可选,默认是从请求中自动推断出来的。 仅与手动测试目的有关,通过斯瓦克.
投入信息输入输入对象由主题和内容组成. 支持自动化表达式 https://dt-url.net/workflows-expression-reference 页面存档备份,存于互联网档案馆 和马克下语法。 附带一个app({ notification type}. notification-template.json)的模板将优先于这里提供的输入.
通知类型字符串字符串,用于定义应用程序上下文中通知的类型。 允许在一个应用程序中区分多种类型的通知.
资源索引字符串要通知的资源唯一标识符 。 用于确定在应用程序和用户通知类型中是否有已登记的资源通知.
标题字符串
触发配置事件调试器配置

事件查询

名称类型说明
事件类型"活""活""活""活""活""活""活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活"活圣杯事件类型.
查询*必须字符串DQL 匹配器表达式定义要匹配的事件 .

事件查询

名称类型
类型*必须"活动"
价值*必须事件查询

修改信息

名称类型
创建By*必须无效 字符串
创建时间*必须日期
上次修改By*必须无效 字符串
上次修改的时间*必须日期

标签式通知列表

名称类型
计数*必须编号
结果*必须矩阵 <事件> 翻译:

通知列表

名称类型
计数*必须编号
结果*必须矩阵 <资源> 翻译:

资源

名称类型说明
应用无效 字符串注册通知的应用代号。 可选,默认是从请求中自动推断出来的。 仅与手动测试目的有关,通过斯瓦克.
编号*必须字符串
修改 资讯*必须修改信息
通知类型*必须字符串字符串,用于定义应用程序上下文中通知的类型。 允许在一个应用程序中区分多种类型的通知.
拥有用户*必须字符串
资源索引*必须字符串要通知的资源唯一标识符 。 用于确定在应用程序和用户通知类型中是否有已登记的资源通知.

资源通知请求

名称类型说明
应用无效 字符串注册通知的应用代号。 可选,默认是从请求中自动推断出来的。 仅与手动测试目的有关,通过斯瓦克.
通知类型*必须字符串字符串,用于定义应用程序上下文中通知的类型。 允许在一个应用程序中区分多种类型的通知.
资源索引*必须字符串要通知的资源唯一标识符 。 用于确定在应用程序和用户通知类型中是否有已登记的资源通知.

事件调试器配置

类型:<a href="#eventquerytrigger config" >EventQuery-trigger Config </a> <a href="#davis problemtrigger config"目标="" blank"rel="诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔诺开尔

数字

戴维斯事件Name 游戏

⚠️ 折旧 使用字面值.

Davis 事件名称必须等于或包含提供的字符串 .

Enum 键

Contains | Equals

戴维斯EventTrigger 字体

⚠️ 折旧 使用字面值.

Enum 键

DavisEvent

Davis Problem Probleg Problem 开放期限

⚠️ 折旧 使用字面值.

最小问题持续时间在起火前几分钟.

Enum 键

DavisProblemConfigProblemOpenDuration_10 | DavisProblemConfigProblemOpenDuration_10080 | DavisProblemConfigProblemOpenDuration_120 | DavisProblemConfigProblemOpenDuration_1440 | DavisProblemConfigProblemOpenDuration_15 | DavisProblemConfigProblemOpenDuration_240 | DavisProblemConfigProblemOpenDuration_30 | DavisProblemConfigProblemOpenDuration_5 | DavisProblemConfigProblemOpenDuration_60

Davis Problem Trigger 图形化

⚠️ 折旧 使用字面值.

Enum 键

DavisProblem

实体标签游戏

⚠️ 折旧 使用字面值.

事件必须匹配全部或任何实体标记 .

Enum 键

All | Any

事件查询

⚠️ 折旧 使用字面值.

Enum 键

Event

事件类型

⚠️ 折旧 使用字面值.

圣杯事件类型.

Enum 键

Bizevents | DtSystemEvents | Events | SecurityEvents

维护窗口

⚠️ 折旧 使用字面值.

根据维护窗口状态指定何时触发.

Enum 键

Always | Inside | Outside

触发

⚠️ 折旧 使用字面值.

Enum 键

Close | Open | OpenAndClose

触发更新字段

⚠️ 折旧 使用字面值.

Enum 键

DtDavisAffectedUsersCount | DtDavisImpactLevel | EventCategory | EventSeverity | RootCauseEntityId | SmartscapeAffectedEntities

版本与发布记录

@dynatrace-sdk/client-notification-v2 共发布 4 个版本,首次发布于 2025/08/12;过去 12 个月发布了 3 个版本。

版本发布日期距今
2.5.0latest2026/07/293 个月前
2.4.12026/06/304 个月前
2.2.02026/06/035 个月前
1.0.02025/08/121.3 年前

关于 @dynatrace-sdk/client-notification-v2 的常见问题

如何安装 @dynatrace-sdk/client-notification-v2?

在项目目录运行 npm install @dynatrace-sdk/client-notification-v2,或使用 pnpm add / yarn add / bun add。

@dynatrace-sdk/client-notification-v2 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dynatrace-sdk/client-notification-v2 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@dynatrace-sdk/client-notification-v2 可以商用吗?

@dynatrace-sdk/client-notification-v2 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@dynatrace-sdk/client-notification-v2 的下载量有多少?

根据 npm 官方下载统计,@dynatrace-sdk/client-notification-v2 在 2026/10/13 – 2026/11/11 这 30 天内被下载 14,440 次,日均约 481 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dynatrace-sdk/client-notification-v2 还在维护吗?

最新版本 2.5.0 发布于 2026/07/29(3 个月前);至今共发布 4 个版本,其中过去 12 个月发布了 3 个;首次发布于 2025/08/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。