InfluxDB 集成
编辑InfluxDB 集成
编辑此集成用于从 InfluxDB OSS 2.x 数据库中摄取任务、存储、golang 和性能相关的指标。此集成提供了开箱即用的仪表板,名为“状态指标”和“高级状态指标”。
要求
编辑此集成依赖于 InfluxDB 的 Prometheus 端点(默认值:http://<InfluxDBhost>:<端口>/metrics
)来收集状态和高级状态指标。
兼容性
编辑此集成已针对 InfluxDB OSS 2.4 和 InfluxDB OSS 2.0 进行测试
指标
编辑状态指标
编辑状态指标包括内存使用情况、OS 线程使用情况、查询统计信息、组织和用户统计信息、任务和任务工作进程、WAL 大小等详细信息。
ECS 字段参考
有关 ECS 字段的详细信息,请参考以下文档。
导出的字段
字段 | 描述 | 类型 | 单位 | 指标类型 |
---|---|---|---|---|
@timestamp |
事件时间戳。 |
日期 |
||
agent.id |
此代理的唯一标识符(如果存在)。示例:对于 Beats,这将是 beat.id。 |
关键词 |
||
cloud.account.id |
用于在多租户环境中标识不同实体的云帐户或组织 ID。示例:AWS 帐户 ID、Google Cloud ORG ID 或其他唯一标识符。 |
关键词 |
||
cloud.availability_zone |
此主机、资源或服务所在的可用区。 |
关键词 |
||
cloud.instance.id |
主机机器的实例 ID。 |
关键词 |
||
cloud.provider |
云提供商的名称。示例值为 aws、azure、gcp 或 digitalocean。 |
关键词 |
||
cloud.region |
此主机、资源或服务所在的区域。 |
关键词 |
||
container.id |
唯一的容器 ID。 |
关键词 |
||
data_stream.dataset |
数据流数据集。 |
常量关键字 |
||
data_stream.namespace |
数据流命名空间。 |
常量关键字 |
||
data_stream.type |
数据流类型。 |
常量关键字 |
||
host.name |
主机的名称。它可以包含 Unix 系统上 hostname 返回的内容、完全限定域名 (FQDN) 或用户指定的名称。建议值为主机的小写 FQDN。 |
关键词 |
||
influxdb.status.buckets_total |
服务器上的存储桶总数。 |
双精度 |
计数器 |
|
influxdb.status.dashboards_total |
服务器上的仪表板总数。 |
双精度 |
计数器 |
|
influxdb.status.go_runtime.memstats_alloc_bytes |
已分配且仍在使用中的字节数。 |
双精度 |
字节 |
计量器 |
influxdb.status.go_runtime.memstats_alloc_bytes_total |
已分配的总字节数,即使已释放。 |
双精度 |
字节 |
计数器 |
influxdb.status.go_runtime.memstats_heap_alloc_bytes |
已分配且仍在使用中的堆字节数。 |
双精度 |
字节 |
计量器 |
influxdb.status.go_runtime.memstats_heap_idle_bytes |
等待使用的堆字节数。 |
双精度 |
字节 |
计量器 |
influxdb.status.go_runtime.memstats_heap_inuse_bytes |
正在使用的堆字节数。 |
双精度 |
字节 |
计量器 |
influxdb.status.go_runtime.threads |
创建的 OS 线程数。 |
双精度 |
计量器 |
|
influxdb.status.http_api.http_status |
HTTP API 请求调用状态。 |
关键词 |
||
influxdb.status.http_api.method |
HTTP 请求方法。 |
关键词 |
||
influxdb.status.http_api.path |
HTTP 请求端点。 |
关键词 |
||
influxdb.status.http_api.response_code |
HTTP API 请求的响应代码。 |
关键词 |
||
influxdb.status.http_api_requests_total |
收到的 HTTP 请求数 |
双精度 |
计数器 |
|
influxdb.status.instance |
InfluxDB 实例。 |
关键词 |
||
influxdb.status.label.bucket |
存储桶 ID |
关键词 |
||
influxdb.status.label.compiler_type |
编译器的类型 |
关键词 |
||
influxdb.status.label.engine |
TSDB 存储引擎 |
关键词 |
||
influxdb.status.label.handler |
请求处理程序。 |
关键词 |
||
influxdb.status.label.id |
关键词 |
|||
influxdb.status.label.job |
作业的类型 |
关键词 |
||
influxdb.status.label.level |
关键词 |
|||
influxdb.status.label.method |
服务操作的类型 |
关键词 |
||
influxdb.status.label.op |
与各种操作相关的扩展信息 |
关键词 |
||
influxdb.status.label.quantile |
指示直方图分位数值的数字。 |
关键词 |
||
influxdb.status.label.task_type |
任务的类型 |
关键词 |
||
influxdb.status.label.taskid |
InfluxDB 任务的任务 ID |
关键词 |
||
influxdb.status.label.user_agent |
用户代理的类型 |
关键词 |
||
influxdb.status.label.walPath |
WAL 文件的路径 |
关键词 |
||
influxdb.status.org |
在 InfluxDB 中创建的组织的组织 ID。 |
关键词 |
||
influxdb.status.organizations_total |
服务器上的组织总数。 |
双精度 |
计数器 |
|
influxdb.status.query_controller.all_active |
所有状态的查询数。 |
双精度 |
计量器 |
|
influxdb.status.query_controller.compiling_active |
正在积极编译的查询数。 |
双精度 |
计量器 |
|
influxdb.status.query_controller.qc_executing_active |
正在积极执行的查询数。 |
双精度 |
计量器 |
|
influxdb.status.scrapers_total |
服务器上的抓取器总数。 |
双精度 |
计数器 |
|
influxdb.status.storage.bucket_measurement_num |
每个存储桶的测量基数计量器。 |
双精度 |
计量器 |
|
influxdb.status.storage.bucket_series_num |
每个存储桶的序列基数计量器。 |
双精度 |
计量器 |
|
influxdb.status.storage.compactions_failed |
由于错误而失败的按级别进行的 TSM 压缩计数器。 |
双精度 |
计数器 |
|
influxdb.status.storage.shard_disk_size |
分片的磁盘大小计量器。 |
双精度 |
计量器 |
|
influxdb.status.storage.shard_write_count |
写入请求的数量计数。 |
双精度 |
计数器 |
|
influxdb.status.storage.shard_write_dropped_sum |
丢弃的点数计数器。 |
双精度 |
计数器 |
|
influxdb.status.storage.shard_write_err_count |
存在错误的写入请求的数量计数。 |
双精度 |
计数器 |
|
influxdb.status.storage.tsm_files_disk_bytes |
每个分片的数据大小计量器,以字节为单位。 |
双精度 |
计量器 |
|
influxdb.status.storage.tsm_files_total |
每个分片的文件数计量器 |
双精度 |
计量器 |
|
influxdb.status.storage.wal_size |
WAL 的大小计量器,以字节为单位。 |
双精度 |
字节 |
计量器 |
influxdb.status.storage.wal_writes |
对 WAL 的写入尝试次数。 |
双精度 |
计数器 |
|
influxdb.status.storage.wal_writes_err |
对 WAL 的失败写入尝试次数。 |
双精度 |
计数器 |
|
influxdb.status.storage.writer_timeouts |
分片写入请求超时的次数。 |
双精度 |
计数器 |
|
influxdb.status.tasks.executor_errors_counter |
执行程序抛出的错误数,以及错误的类型。示例 - 无效、内部等。 |
双精度 |
计数器 |
|
influxdb.status.tasks.executor_total_runs_active |
当前正在运行任务的工作进程总数。 |
双精度 |
计量器 |
|
influxdb.status.tasks.executor_total_runs_complete |
跨所有任务完成的运行总数,按成功或失败进行拆分。 |
双精度 |
计数器 |
|
influxdb.status.tasks.executor_workers_busy |
当前繁忙的可用工作进程总数的百分比。 |
双精度 |
百分比 |
计量器 |
influxdb.status.tasks.scheduler_current_execution |
当前正在执行的任务数。 |
双精度 |
计量器 |
|
influxdb.status.tasks.scheduler_total_execute_failure |
执行失败的总次数。 |
双精度 |
计数器 |
|
influxdb.status.tasks.scheduler_total_execution_calls |
跨所有任务的执行总数。 |
双精度 |
计数器 |
|
influxdb.status.tasks.scheduler_total_release_calls |
释放请求的总数。 |
双精度 |
计数器 |
|
influxdb.status.tasks.scheduler_total_schedule_calls |
计划请求的总数。 |
双精度 |
计数器 |
|
influxdb.status.tasks.scheduler_total_schedule_fails |
未能计划的计划请求的总数。 |
双精度 |
计数器 |
|
influxdb.status.tokens_total |
服务器上的令牌总数。 |
双精度 |
计数器 |
|
influxdb.status.uptime_seconds |
InfluxDB 进程的正常运行时间,以秒为单位。 |
双精度 |
秒 |
计量器 |
influxdb.status.users_total |
服务器上的用户总数。 |
双精度 |
计数器 |
|
service.address |
从中收集有关此服务的数据的地址。这应该是一个 URI、网络地址 (ipv4:port 或 [ipv6]:port) 或资源路径(套接字)。 |
关键词 |
示例
一个 status
的示例事件如下所示
{ "@timestamp": "2022-09-22T05:55:26.485Z", "agent": { "ephemeral_id": "512929a4-20a5-4e02-97d3-f089acc3dc8f", "id": "f89b312e-866e-4215-bbb4-f0ddec5e4872", "name": "docker-fleet-agent", "type": "metricbeat", "version": "8.3.0" }, "cloud": { "account": { "id": "elastic-obs-integrations-dev" }, "availability_zone": "asia-south1-c", "instance": { "id": "3010911784348669868", "name": "service-integration-dev-idc-01" }, "machine": { "type": "n1-standard-8" }, "project": { "id": "elastic-obs-integrations-dev" }, "provider": "gcp", "service": { "name": "GCE" } }, "data_stream": { "dataset": "influxdb.status", "namespace": "ep", "type": "metrics" }, "ecs": { "version": "8.11.0" }, "elastic_agent": { "id": "f89b312e-866e-4215-bbb4-f0ddec5e4872", "snapshot": false, "version": "8.3.0" }, "event": { "agent_id_status": "verified", "dataset": "influxdb.status", "duration": 6154570, "ingested": "2022-09-22T05:55:27Z", "module": "prometheus" }, "host": { "architecture": "x86_64", "containerized": true, "hostname": "docker-fleet-agent", "ip": [ "192.168.80.7" ], "mac": [ "02-42-AC-1F-00-07" ], "name": "docker-fleet-agent", "os": { "codename": "focal", "family": "debian", "kernel": "5.4.0-1078-gcp", "name": "Ubuntu", "platform": "ubuntu", "type": "linux", "version": "20.04.4 LTS (Focal Fossa)" } }, "influxdb": { "status": { "http_api": { "path": "/var/lib/influxdb2/engine" }, "instance": "elastic-package-service_influxdb_1:8086", "storage": { "writer_timeouts": 0 } } }, "metricset": { "name": "collector", "period": 60000 }, "prometheus": { "labels": {} }, "service": { "address": "http://elastic-package-service_influxdb_1:8086/metrics", "type": "prometheus" } }
高级状态指标
编辑高级状态指标包括查询执行统计信息、压缩级别、保留详细信息、错误和部分写入、延迟等详细信息。
ECS 字段参考
有关 ECS 字段的详细信息,请参考以下文档。
导出的字段
字段 | 描述 | 类型 |
---|---|---|
@timestamp |
事件时间戳。 |
日期 |
agent.id |
此代理的唯一标识符(如果存在)。示例:对于 Beats,这将是 beat.id。 |
关键词 |
cloud.account.id |
用于在多租户环境中标识不同实体的云帐户或组织 ID。示例:AWS 帐户 ID、Google Cloud ORG ID 或其他唯一标识符。 |
关键词 |
cloud.availability_zone |
此主机、资源或服务所在的可用区。 |
关键词 |
cloud.instance.id |
主机机器的实例 ID。 |
关键词 |
cloud.provider |
云提供商的名称。示例值为 aws、azure、gcp 或 digitalocean。 |
关键词 |
cloud.region |
此主机、资源或服务所在的区域。 |
关键词 |
container.id |
唯一的容器 ID。 |
关键词 |
data_stream.dataset |
数据流数据集。 |
常量关键字 |
data_stream.namespace |
数据流命名空间。 |
常量关键字 |
data_stream.type |
数据流类型。 |
常量关键字 |
host.name |
主机的名称。它可以包含 Unix 系统上 hostname 返回的内容、完全限定域名 (FQDN) 或用户指定的名称。建议值为主机的小写 FQDN。 |
关键词 |
influxdb.advstatus.instance |
InfluxDB 实例。 |
关键词 |
influxdb.advstatus.labels.bucket |
存储桶 ID |
关键词 |
influxdb.advstatus.labels.compiler_type |
编译器的类型 |
关键词 |
influxdb.advstatus.labels.engine |
TSDB 存储引擎 |
关键词 |
influxdb.advstatus.labels.handler |
请求处理程序。 |
关键词 |
influxdb.advstatus.labels.id |
关键词 |
|
influxdb.advstatus.labels.job |
作业的类型 |
关键词 |
influxdb.advstatus.labels.level |
表示级别值,例如缓存、完整等 |
关键词 |
influxdb.advstatus.labels.method |
服务操作的类型 |
关键词 |
influxdb.advstatus.labels.op |
与各种操作相关的扩展信息 |
关键词 |
influxdb.advstatus.labels.path |
HTTP 请求端点。 |
关键词 |
influxdb.advstatus.labels.quantile |
指示直方图分位数值的数字。 |
关键词 |
influxdb.advstatus.labels.task_type |
任务的类型 |
关键词 |
influxdb.advstatus.labels.taskid |
InfluxDB 任务的任务 ID |
关键词 |
influxdb.advstatus.labels.user_agent |
用户代理的类型 |
关键词 |
influxdb.advstatus.labels.walPath |
WAL 文件的路径 |
关键词 |
influxdb.advstatus.org |
在 InfluxDB 中创建的组织的组织 ID。 |
关键词 |
influxdb.advstatus.query_controller.all_duration_seconds.histogram |
所有查询状态下花费的总时间的直方图。 |
直方图 |
influxdb.advstatus.query_controller.compiling_duration_seconds.histogram |
编译查询所花费的时间的直方图。 |
直方图 |
influxdb.advstatus.query_controller.executing_duration_seconds.histogram |
执行查询所花费的时间的直方图。 |
直方图 |
influxdb.advstatus.storage.compactions_duration_seconds.histogram |
自启动以来按级别进行的压缩的直方图。 |
直方图 |
influxdb.advstatus.storage.retention_check_duration.histogram |
保留检查的持续时间(以秒为单位)的直方图。 |
直方图 |
influxdb.advstatus.storage.writer_dropped_points.histogram |
由于部分写入而丢弃的点数的直方图。 |
直方图 |
influxdb.advstatus.storage.writer_err_points.histogram |
错误的分片写入请求中的点数的直方图。 |
直方图 |
influxdb.advstatus.storage.writer_ok_points.histogram |
成功的分片写入请求中的点数的直方图。 |
直方图 |
influxdb.advstatus.storage.writer_req_points.histogram |
请求写入的点数的直方图。 |
直方图 |
influxdb.advstatus.tasks.executor_run_latency_seconds.histogram |
记录任务应运行的时间与任务开始执行的时间之间的延迟,按任务类型划分。 |
直方图 |
influxdb.advstatus.tasks.executor_run_queue_delta.histogram |
运行应该开始的时间和实际开始之间的时间间隔,以秒为单位。 |
直方图 |
service.address |
从中收集有关此服务的数据的地址。这应该是一个 URI、网络地址 (ipv4:port 或 [ipv6]:port) 或资源路径(套接字)。 |
关键词 |
示例
一个 advstatus
的示例事件如下所示
{ "@timestamp": "2022-09-22T05:54:15.452Z", "agent": { "ephemeral_id": "2928ccbb-957a-4054-9e87-c1af939d1ebf", "id": "f89b312e-866e-4215-bbb4-f0ddec5e4872", "name": "docker-fleet-agent", "type": "metricbeat", "version": "8.3.0" }, "cloud": { "account": { "id": "elastic-obs-integrations-dev" }, "availability_zone": "asia-south1-c", "instance": { "id": "3010911784348669868", "name": "service-integration-dev-idc-01" }, "machine": { "type": "n1-standard-8" }, "project": { "id": "elastic-obs-integrations-dev" }, "provider": "gcp", "service": { "name": "GCE" } }, "data_stream": { "dataset": "influxdb.advstatus", "namespace": "ep", "type": "metrics" }, "ecs": { "version": "8.11.0" }, "elastic_agent": { "id": "f89b312e-866e-4215-bbb4-f0ddec5e4872", "snapshot": false, "version": "8.3.0" }, "event": { "agent_id_status": "verified", "dataset": "influxdb.advstatus", "duration": 5889790, "ingested": "2022-09-22T05:54:16Z", "module": "prometheus" }, "host": { "architecture": "x86_64", "containerized": true, "hostname": "docker-fleet-agent", "ip": [ "192.168.80.7" ], "mac": [ "02-42-AC-1F-00-07" ], "name": "docker-fleet-agent", "os": { "codename": "focal", "family": "debian", "kernel": "5.4.0-1078-gcp", "name": "Ubuntu", "platform": "ubuntu", "type": "linux", "version": "20.04.4 LTS (Focal Fossa)" } }, "influxdb": { "advstatus": { "instance": "elastic-package-service_influxdb_1:8086", "labels": {}, "storage": { "writer_dropped_points": { "histogram": { "counts": [ 0, 0, 0, 0, 0, 0 ], "values": [ 5, 55, 550, 5500, 55000, 190000 ] } }, "writer_err_points": { "histogram": { "counts": [ 0, 0, 0, 0, 0, 0 ], "values": [ 5, 55, 550, 5500, 55000, 190000 ] } }, "writer_ok_points": { "histogram": { "counts": [ 0, 0, 0, 0, 0, 0 ], "values": [ 5, 55, 550, 5500, 55000, 190000 ] } }, "writer_req_points": { "histogram": { "counts": [ 0, 0, 0, 0, 0, 0 ], "values": [ 5, 55, 550, 5500, 55000, 190000 ] } } }, "storage_writer_dropped_points": {}, "storage_writer_err_points": {}, "storage_writer_ok_points": {}, "storage_writer_req_points": {} } }, "metricset": { "name": "collector", "period": 60000 }, "service": { "address": "http://elastic-package-service_influxdb_1:8086/metrics", "type": "prometheus" } }
更新日志
编辑更新日志
版本 | 详细信息 | Kibana 版本 |
---|---|---|
0.10.0 |
增强 (查看拉取请求) |
— |
0.9.0 |
增强 (查看拉取请求) |
— |
0.8.0 |
增强 (查看拉取请求) |
— |
0.7.0 |
增强 (查看拉取请求) |
— |
0.6.0 |
增强 (查看拉取请求) |
— |
0.5.0 |
增强功能 (查看拉取请求) |
— |
0.4.3 |
Bug 修复 (查看拉取请求) |
— |
0.4.2 |
Bug 修复 (查看拉取请求) |
— |
0.4.1 |
Bug 修复 (查看拉取请求) |
— |
0.4.0 |
增强功能 (查看拉取请求) |
— |
0.3.0 |
增强功能 (查看拉取请求) |
— |
0.2.1 |
增强功能 (查看拉取请求) |
— |
0.2.0 |
增强功能 (查看拉取请求) |
— |
0.1.0 |
增强功能 (查看拉取请求) |
— |