Span API编辑

Span 用于度量单个事件的持续时间。创建 Span 后,它将度量从创建到调用 span.end() 的时间。

要获取 Span 对象,您需要调用 apm.startSpan()

span.name编辑

  • 类型: 字符串
  • 默认值: Unknown

Span 的名称。这也可以通过 apm.startSpan() 设置。

span.type编辑

  • 类型: 字符串
  • 默认值: custom

Span 的类型。这也可以通过 apm.startSpan() 设置。

类型是一个分层字符串,用于将类似的 Span 分组在一起。例如,所有传出的 AJAX 请求都被赋予类型 external.http

在上面的例子中,external 被认为是类型前缀。虽然此前缀没有命名限制,但在所有 Elastic APM 代理中,以下前缀是标准化的:appdbcachetemplateexternal

span.addLabels()编辑

span.addLabels({ [name]: value })

在 Span 上添加多个标签。如果在 Span 期间发生错误,它也会被标记上相同的标签。

参数

  • name - 任何字符串。所有句点 (.)、星号 (*) 和双引号 (") 都将替换为下划线 (_),因为这些字符在 Elasticsearch 中具有特殊含义
  • value - 任何字符串、布尔值或数字。所有其他数据类型将在发送到 APM 服务器之前转换为字符串。

span.end()编辑

span.end()

结束 Span。如果 Span 已经结束,则不会发生任何事情。