InfluxDB 集成

编辑

版本

0.10.0 [测试版] 此功能为测试版,可能会发生更改。其设计和代码不如正式 GA 功能成熟,按原样提供,不提供任何保证。测试版功能不受正式 GA 功能的支持 SLA 约束。 (查看全部)

兼容的 Kibana 版本

8.13.0 或更高版本

支持的无服务器项目类型
这是什么?

安全性
可观测性

订阅级别
这是什么?

基本

支持级别
这是什么?

Elastic

此集成用于从 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

增强 (查看拉取请求)
为 advstatus 和 status 数据流添加处理器支持。

0.9.0

增强 (查看拉取请求)
ECS 版本更新至 8.11.0。将 kibana 约束更新为 ^8.13.0。修改了字段定义,以删除 ecs@mappings 组件模板中变得冗余的 ECS 字段。

0.8.0

增强 (查看拉取请求)
在 data_stream.dataset 上添加全局筛选器以提高性能。

0.7.0

增强 (查看拉取请求)
将软件包 format_version 更新为 3.0.0。

0.6.0

增强 (查看拉取请求)
为指标数据集启用时间序列数据流。这可以大大减少指标的存储,并有望逐步提高查询性能。有关更多详细信息,请参阅https://elastic.ac.cn/guide/en/elasticsearch/reference/current/tsds.html

0.5.0

增强功能 (查看拉取请求)
将所有权从 obs-service-integrations 重命名为 obs-infraobs-integrations

0.4.3

Bug 修复 (查看拉取请求)
为状态数据流添加了额外的维度字段。

0.4.2

Bug 修复 (查看拉取请求)
修改了维度字段映射以支持公共云部署。

0.4.1

Bug 修复 (查看拉取请求)
为 advstatus 数据流添加了额外的维度字段。

0.4.0

增强功能 (查看拉取请求)
将可视化迁移到 Lens。

0.3.0

增强功能 (查看拉取请求)
包含了 TSDB 启用更改,以及小的 Bug 修复。

0.2.1

增强功能 (查看拉取请求)
添加了类别和/或子类别。

0.2.0

增强功能 (查看拉取请求)
将 ECS 版本更新至 8.5.1

0.1.0

增强功能 (查看拉取请求)
此集成用于从 InfluxDB OSS 2.x 数据库中提取任务、存储、golang 和性能相关的指标。