Dynatrace OpenKit - JavaScript 引用执行
: 資訊 來源: 我们把默认分支名称更改为 main。 您可以找到必要的步骤来更新本地克隆 斯科特·汉塞尔曼博客。 。 。 .
我们鼓励您在叉子中重命名默认分支 .
开刀是什么?
OpenKit提供了一种简单而轻巧的方法,通过对Dynatrace应用程序的源代码进行仪器化,以获得对应用程序的洞察.
它最适合从后端分出运行的应用程序,并通过HTTP进行通信,如丰富的客户端应用程序,嵌入式设备,终端等.
OpenKit的一大优点是它的设计是为了
- 尽可能容易使用
- 尽可能无依赖性(不需要第三方库或Dynatrace Agent)
- 易于移植到其他语言和平台
此寄存器包含纯TypeScript中的引用执行. 其他执行情况如下:
- . NET : (中文(简体) ) https://github.com/Dynatrace/openkit-dotnet/ 互联网档案馆的存檔,存档日期2013-12-22
- 爪哇语 : https://github.com/ Dynatrace/openkit-java/ 互联网档案馆的存檔,存档日期2013-12-21
- 丙++: https://github.com/Dynatrace/openkit-native/ 页面存档备份,存于互联网档案馆
您可以对 OpenKit- Java 脚本做什么
- 创建会话和用户动作
- 在会话中识别用户
- 行动价值报告
- 与 Dynatrace 一起使用
- 追踪网络请求到服务器侧纯派
无法使用 OpenKit 的
- 创建服务器侧纯PurePaths( 此功能由 一个代理 SDKs(中文(简体) )
- 创建参数( 使用 自定义网络设备 API 指标)
设计原则
- API应该尽可能简单易懂
- 如果可能, OpenKit 使用不当仍应导致有效结果
- 设计重新输入API并文档
运行时间要求
承诺
OpenKit 需要承诺才能工作。 如果你的环境不支持他们,他们可以 使用多填充库进行多填充.
通信图书馆
如果您使用平台而不获取或节点.js 低于 18, 您必须使用多填充 获取 API,或提供您可以使用协议的通信频道执行 您想要(例如MQTT).
从 npm 获取 OpenKit
OpenKit 可用在 无 并且应该通过 npm 或纱线使用.
对于浏览器来说, 镜像服务像 日记 可以使用.
<script
type="text/javascript"
src="https://cdn.jsdelivr.net/npm/@dynatrace/[email protected]/dist/browser/openkit.js"
></script>
捐款与发展
一般概念
这一部分解释了整个OpenKit使用的概念。 如何使用 OpenKit 的简短样本 还提供。 详细代码样本需要查看 实例d 和代码文档.
打开 Kit 构建器
一个 OpenKitBuilder 实例负责获取和设定应用程序相关信息,例如:.
应用程序的版本和设备特定信息.
打开 Kit
这个 OpenKit 负责创建用户会话(参见 Session) (中文(简体) ).
虽然可以有多种 OpenKit 连接到同一端点的事件
在一个进程中,应当有一个独特的实例.
会议
A 类 Session 代表一种用户会话,类似于网页应用程序中的浏览器会话.
然而,应用程序开发者可以自由选择如何对待 Session。 。 。 .
这个 Session 用于创建 Action 实例、报告应用程序崩溃、识别用户和
以跟踪没有网络请求 Action 可用.
当a Session 不再需要它,它被强烈建议结束它,使用 Session.end() 方法.
行动
这个 Action 标出分级的节点,用于计时,并附上进一步的细节.
一个 Action 从 Session. 动作提供了附加密钥值对的可能性,
标记事件和错误,并可用于追踪网络请求.
Web 请求追踪器
当应用程序开发者想要追踪网络请求时, 由服务服务提供
dynatrace的仪器,a WebRequestTracer 应使用,这可以是
请求 Action 财务报告和审定财务报表 Session。 。 。 .
命名的事件
一个名字 Event 附于一个 Action 并包含一个名字.
键值对等
对于一个 Action 也可以报告密钥值对。 键总是弦
值可能为 a number 或一个 string。所有报告的数字作为浮动点处理
dynatrace的数值.
错误和崩溃( C)
错误是报告错误条件的一种方式 Action。 。 。 .
崩溃用于报告(未处理的)例外情况 Session。 。 。 .
识别用户
OpenKit 允许您用独特的用户标记标记会话 。 用户标签为字符串 允许唯一识别单一用户.
示例
这个小例子提供了如何使用OpenKit的粗略概述. 详细解释见 实例d。 。 。 .
const applicationID = 'application-id';
const deviceID = 42;
const endpointURL = 'https://tenantid.beaconurl.com/mbeacon';
const openKit = new OpenKitBuilder(endpointURL, applicationID, deviceID)
.withApplicationVersion('1.0.0.0')
.withOperatingSystem('Windows 10')
.withManufacturer('MyCompany')
.withModelId('MyModelId')
.build();
const timeoutInMilliseconds = 10 * 1000;
openKit.waitForInit((success) => {
if (success) {
const clientIP = '8.8.8.8';
const session = openKit.createSession(clientIP);
session.identifyUser('[email protected]');
const actionName = 'rootActionName';
const action = session.enterAction(actionName);
action.leaveAction();
session.end();
openKit.shutdown();
}
}, timeoutInMilliseconds);