JMX 配置选项

capture_jmx_metrics ( [1.11.0] 在 1.11.0 中添加。 )编辑

将 JMX 指标报告到 APM Server

可以包含多个以逗号分隔的 JMX 指标定义

object_name[<JMX object name pattern>] attribute[<JMX attribute>:metric_name=<optional metric name>]

代理为每个 JMX 键属性（如 type 和 name）创建 labels。

JMX 对象名称模式 支持通配符。属性定义不支持通配符，但接受特殊定义 attribute[*]（从 1.44.0 开始），表示匹配与关联的对象名称模式匹配的所有可能的（数字）属性。定义 object_name[*:type=*,name=*] attribute[*] 将匹配所有可能的 JMX 指标。在以下示例中，代理将为每个内存池 name（如 G1 Old Generation 和 G1 Young Generation）创建一个指标集。

object_name[java.lang:type=GarbageCollector,name=*] attribute[CollectionCount:metric_name=collection_count] attribute[CollectionTime]

Elasticsearch 中的结果文档类似于以下内容（为了简洁起见，省略了元数据）

{
  "@timestamp": "2019-08-20T16:51:07.512Z",
  "jvm": {
    "jmx": {
      "collection_count": 0,
      "CollectionTime":   0
    }
  },
  "labels": {
    "type": "GarbageCollector",
    "name": "G1 Old Generation"
  }
}

{
  "@timestamp": "2019-08-20T16:51:07.512Z",
  "jvm": {
    "jmx": {
      "collection_count": 2,
      "CollectionTime":  11
    }
  },
  "labels": {
    "type": "GarbageCollector",
    "name": "G1 Young Generation"
  }
}

代理还支持属性值的复合值。在此示例中，HeapMemoryUsage 是一个复合值，由 committed、init、used 和 max 组成。

object_name[java.lang:type=Memory] attribute[HeapMemoryUsage:metric_name=heap]

Elasticsearch 中的结果文档类似于以下内容

{
  "@timestamp": "2019-08-20T16:51:07.512Z",
  "jvm": {
    "jmx": {
      "heap": {
        "max":      4294967296,
        "init":      268435456,
        "committed": 268435456,
        "used":       22404496
      }
    }
  },
  "labels": {
    "type": "Memory"
  }
}