Azure Application Insights 集成

编辑

Azure Application Insights 集成

编辑

版本

1.7.0 (查看全部)

兼容的 Kibana 版本

8.13.0 或更高版本

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

安全性
可观测性

订阅级别
这是什么?

基本

Application Insights 集成允许用户从指定的应用程序检索应用程序洞察指标。

集成级别配置选项
编辑
应用程序 ID
([]string) 应用程序的 ID。这是 Azure 门户中“API 访问设置”边栏中的“应用程序 ID”。
API 密钥
([]string) 将生成的 API 密钥,更多步骤请参阅此处 https://dev.applicationinsights.io/documentation/Authorization/API-key-and-App-ID
配置选项
编辑
指标
要收集信息的不同指标的列表
id
([]string) 正在报告的指标的 ID。通常,id 具有足够的描述性,有助于识别所测量的内容。默认指标包括精选的请求计数器、性能和服务可用性。选项列表可以在此处找到 https://docs.microsoft.com/en-us/rest/api/application-insights/metrics/get#metricid
间隔
(string) 检索指标值时要使用的时间间隔。这是一个 ISO8601 持续时间。如果省略 interval,则将在整个时间跨度内聚合指标值。如果提供了 interval,则结果可能会根据用于查询的时间跨度将 interval 调整为更合适的大小。
聚合
([]string) 计算指标值时要使用的聚合。要一次检索多个聚合,请用逗号分隔它们。如果未指定聚合,则使用指标的默认聚合。
分段
([]string) 用于分割指标值的维度的名称。此维度必须适用于您正在检索的指标。在这种情况下,指标数据将按照参数中列出的维度顺序进行分段。
top
(int) 要返回的分段数。仅当指定分段时,此值才有效。
order_by
(string) 用于对分段进行排序的聚合函数和方向。仅当指定分段时,此值才有效。
筛选器
(string) 用于筛选结果的表达式。此值应为有效的 OData 筛选器表达式,其中每个子句的键应适用于您正在检索的指标的维度。

配置示例

 - id: ["requests/count", "requests/failed"]
   segment: "request/name"
   aggregation: ["sum"]

关于指标和成本的附加说明

编辑

成本:指标查询根据标准 API 调用的数量收费。有关定价的更多信息,请参阅此处 https://azure.microsoft.com/en-us/pricing/details/monitor/

示例

app_insights 的示例事件如下所示

{
    "@timestamp": "2021-08-23T14:37:42.268Z",
    "agent": {
        "ephemeral_id": "4162d5df-ab00-4c1b-b4f3-7db2e3b599d4",
        "hostname": "docker-fleet-agent",
        "id": "d979a8cf-ddeb-458f-9019-389414e0ab47",
        "name": "docker-fleet-agent",
        "type": "metricbeat",
        "version": "7.15.0"
    },
    "azure": {
        "app_insights": {
            "end_date": "2021-08-23T14:37:42.268Z",
            "start_date": "2021-08-23T14:32:42.268Z"
        },
        "application_id": "42cb59a9-d5be-400b-a5c4-69b0a0026ac6",
        "dimensions": {
            "request_name": "GET Home/Index",
            "request_url_host": "demoappobs.azurewebsites.net"
        },
        "metrics": {
            "requests_count": {
                "sum": 4
            }
        }
    },
    "cloud": {
        "provider": "azure"
    },
    "data_stream": {
        "dataset": "azure.app_insights",
        "namespace": "default",
        "type": "metrics"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "d979a8cf-ddeb-458f-9019-389414e0ab47",
        "snapshot": true,
        "version": "7.15.0"
    },
    "event": {
        "agent_id_status": "verified",
        "dataset": "azure.app_insights",
        "duration": 503187300,
        "ingested": "2021-08-23T14:37:41Z",
        "module": "azure"
    },
    "host": {
        "architecture": "x86_64",
        "containerized": true,
        "hostname": "docker-fleet-agent",
        "id": "1642d255f9a32fc6926cddf21bb0d5d3",
        "ip": [
            "192.168.96.7"
        ],
        "mac": [
            "02-42-AC-1F-00-07"
        ],
        "name": "docker-fleet-agent",
        "os": {
            "codename": "Core",
            "family": "redhat",
            "kernel": "4.19.128-microsoft-standard",
            "name": "CentOS Linux",
            "platform": "centos",
            "type": "linux",
            "version": "7 (Core)"
        }
    },
    "metricset": {
        "name": "app_insights",
        "period": 300000
    },
    "service": {
        "type": "azure"
    }
}

更新日志

编辑
更新日志
版本 详细信息 Kibana 版本

1.7.0

增强功能 (查看拉取请求)
为 app_insights 和 app_state 数据流添加处理器支持。

8.13.0 或更高版本

1.6.0

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

8.13.0 或更高版本

1.5.0

增强功能 (查看拉取请求)
为仪表板添加全局过滤器,以提高性能。

8.12.0 或更高版本

1.4.0

增强功能 (查看拉取请求)
为敏感字段启用secret

8.12.0 或更高版本

1.3.0

增强功能 (查看拉取请求)
为指标数据流启用时间序列数据。这大大减少了指标的存储空间,并且有望逐步提高查询[性能](https://elastic.ac.cn/blog/70-percent-storage-savings-for-metrics-with-elastic-observability)。有关更多详细信息,请参阅 https://elastic.ac.cn/guide/en/elasticsearch/reference/current/tsds.html

8.12.0 或更高版本

1.2.3

错误修复 (查看拉取请求)
重命名 app insights 维度指纹字段,以防止其嵌套在 azure.dimensions 中。

8.9.0 或更高版本

1.2.2

增强功能 (查看拉取请求)
将 App State Overview 仪表板可视化迁移到 Lens。

8.9.0 或更高版本

1.2.1

增强功能 (查看拉取请求)
向 app_state 数据流添加维度和 metric_type 映射

8.9.0 或更高版本

1.2.0

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

8.9.0 或更高版本

1.1.0

增强功能 (查看拉取请求)
为指标字段添加 app_insights 维度和 metric_type。

8.9.0 或更高版本

1.0.6

增强功能 (查看拉取请求)
修复标签和维度的映射

7.14.0 或更高版本
8.0.0 或更高版本

1.0.5

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

7.14.0 或更高版本
8.0.0 或更高版本

1.0.4

错误修复 (查看拉取请求)
修复了 app_state 数据流中拼写错误的字段名称。

7.14.0 或更高版本
8.0.0 或更高版本

1.0.3

增强功能 (查看拉取请求)
更新了 Readme

7.14.0 或更高版本
8.0.0 或更高版本

1.0.2

增强功能 (查看拉取请求)
添加了多字段的文档

1.0.1

增强功能 (查看拉取请求)
从数据流中删除 beta 发布标签

7.14.0 或更高版本
8.0.0 或更高版本

1.0.0

增强功能 (查看拉取请求)
将 azure_application_insights 软件包移至 GA

7.14.0 或更高版本
8.0.0 或更高版本

0.3.1

增强功能 (查看拉取请求)
更新至 ECS 8.0

0.3.0

增强功能 (查看拉取请求)
支持 Kibana 8.0

0.2.1

增强功能 (查看拉取请求)
与指南保持一致

0.2.0

增强功能 (查看拉取请求)
更新至 ECS 1.12.0

0.1.0

增强功能 (查看拉取请求)
初始发布