« Azure 资源指标集成 Azure 存储帐户集成 »
Elastic 文档 ›Elastic 集成 ›Azure 日志集成

Azure Spring Apps 日志

编辑

Azure Spring Apps 日志

编辑

版本

1.20.1 (查看全部)

兼容的 Kibana 版本

8.13.0 或更高版本

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

安全性
可观测性

订阅级别
这是什么？

基本

Azure Spring Apps 日志集成提供了对 Azure Spring Apps 应用程序操作的洞察。

选择 Elastic Cloud 原生 Azure 集成的用户可以直接将 Azure Spring Apps 日志流式传输到其合作伙伴解决方案集群；您可以在此处找到更多信息和步骤。

要求和设置

编辑

有关设置和使用此集成的更多信息，请参阅Azure 日志页面。

设置

编辑

eventhub：字符串它是一种完全托管的实时数据引入服务。Elastic 建议仅使用字母、数字和连字符 (-) 作为事件中心名称，以最大限度地提高兼容性。您可以使用事件中心名称中带有下划线 (_) 的现有事件中心；在这种情况下，当集成使用事件中心名称在幕后创建依赖的 Azure 资源时（例如，存储事件中心使用者偏移量的存储帐户容器），集成会将下划线替换为连字符 (-)。Elastic 还建议为每种日志类型使用单独的事件中心，因为每种日志类型的字段映射都不同。默认值 insights-operational-logs。

consumer_group：字符串事件中心的发布/订阅机制通过使用者组启用。使用者组是整个事件中心的视图（状态、位置或偏移量）。使用者组使多个使用应用程序能够各自拥有事件流的单独视图，并以自己的速度和自己的偏移量独立读取流。默认值：$Default

connection_string：字符串与事件中心通信所需的连接字符串，步骤请参阅 https://docs.microsoft.com/en-us/azure/event-hubs/event-hubs-get-connection-string。

需要 Blob 存储帐户才能存储/检索/更新事件中心消息的偏移量或状态。这意味着在停止 filebeat azure 模块后，它可以从停止处理消息的位置重新启动。

storage_account：字符串将存储和更新状态/偏移量的存储帐户的名称。

storage_account_key：字符串存储帐户密钥，此密钥将用于授权访问存储帐户中的数据。

storage_account_container：字符串集成存储使用者组的检查点数据的存储帐户容器。这是一个高级选项，使用时必须格外小心。您必须为每种 Azure 日志类型（活动、登录、审核日志等）使用专用的存储帐户容器。不要为多个 Azure 日志类型重复使用相同的容器名称。有关 Microsoft 的命名规则的详细信息，请参阅 容器名称。如果未指定，集成将生成默认容器名称。

resource_manager_endpoint：字符串可选，默认情况下我们使用的是 Azure 公共环境，要覆盖此设置，用户可以提供特定的资源管理器端点以使用不同的 Azure 环境。

资源管理器端点

# Azure ChinaCloud
https://management.chinacloudapi.cn/

# Azure GermanCloud
https://management.microsoftazure.de/

# Azure PublicCloud
https://management.azure.com/

# Azure USGovernmentCloud
https://management.usgovcloudapi.net/

日志

编辑
springappslogs
编辑

这是 Azure 日志包的 springcloudlogs 数据流。它将收集已通过 Azure 事件中心流式传输的所有 Spring Apps 日志。

示例

springcloudlogs 的示例事件如下所示

{
    "@timestamp": "2021-08-03T15:07:03.354Z",
    "agent": {
        "ephemeral_id": "49d0a57c-119c-4a01-878c-d9b06fc81f65",
        "hostname": "docker-fleet-agent",
        "id": "ef999bb2-fe83-4ffa-aa0c-0b54b7598df4",
        "name": "docker-fleet-agent",
        "type": "filebeat",
        "version": "7.14.0"
    },
    "azure": {
        "resource": {
            "group": "TESTM",
            "id": "/SUBSCRIPTIONS/0E073EC1-C22F-4488-ADDE-DA35ED609CCD/RESOURCEGROUPS/TESTM/PROVIDERS/MICROSOFT.APPPLATFORM/SPRING/OBSSPRINCLOUD",
            "name": "OBSSPRINCLOUD",
            "provider": "MICROSOFT.APPPLATFORM/SPRING"
        },
        "springcloudlogs": {
            "category": "ApplicationConsole",
            "event_category": "Administrative",
            "log_format": "RAW",
            "logtag": "F",
            "operation_name": "Microsoft.AppPlatform/Spring/logs",
            "properties": {
                "app_name": "helloapp",
                "instance_name": "helloapp-default-8-56df6b7f56-4vr94",
                "service_id": "99070c7524f14eaf970bbdf35f357772",
                "service_name": "obssprincloud",
                "stream": "stdout"
            }
        },
        "subscription_id": "0E073EC1-C22F-4488-ADDE-DA35ED609CCD"
    },
    "cloud": {
        "provider": "azure"
    },
    "data_stream": {
        "dataset": "azure.springcloudlogs",
        "namespace": "default",
        "type": "logs"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "ef999bb2-fe83-4ffa-aa0c-0b54b7598df4",
        "snapshot": true,
        "version": "7.14.0"
    },
    "event": {
        "action": "Microsoft.AppPlatform/Spring/logs",
        "agent_id_status": "verified",
        "dataset": "azure.springcloudlogs",
        "ingested": "2021-08-03T15:15:14.386889100Z",
        "kind": "event"
    },
    "geo": {
        "name": "westeurope"
    },
    "log": {
        "level": "Informational"
    },
    "message": "2021-08-03 15:07:03.354  INFO [helloapp,,,] 1 --- [trap-executor-0] c.n.d.s.r.aws.ConfigClusterResolver      : Resolving eureka endpoints via configuration",
    "tags": [
        "azure-springcloudlogs"
    ]
}

ECS 字段参考

有关 ECS 字段的详细信息，请参阅以下文档。

导出的字段
字段 描述 类型

@timestamp

事件时间戳。

日期

azure.correlation_id

关联 ID

关键字

azure.resource.authorization_rule

授权规则

关键字

azure.resource.group

资源组

关键字

azure.resource.id

资源 ID

关键字

azure.resource.name

名称

关键字

azure.resource.namespace

资源类型/命名空间

关键字

azure.resource.provider

资源类型/命名空间

关键字

azure.springcloudlogs.category

类别

关键字

azure.springcloudlogs.event_category

事件类别

关键字

azure.springcloudlogs.log_format

ccpNamespace

关键字

azure.springcloudlogs.logtag

云

关键字

azure.springcloudlogs.operation_name

操作名称

关键字

azure.springcloudlogs.properties.app_name

应用程序名称

关键字

azure.springcloudlogs.properties.instance_name

实例名称

关键字

azure.springcloudlogs.properties.logger

记录器

关键字

azure.springcloudlogs.properties.service_id

服务 ID

关键字

azure.springcloudlogs.properties.service_name

服务名称

关键字

azure.springcloudlogs.properties.stack

堆栈名称

关键字

azure.springcloudlogs.properties.stream

流

关键字

azure.springcloudlogs.properties.thread

线程

关键字

azure.springcloudlogs.properties.type

类型

关键字

azure.springcloudlogs.status

状态

关键字

azure.subscription_id

Azure 订阅 ID

关键字

azure.tenant_id

租户 ID

关键字

cloud.image.id

云实例的镜像 ID。

关键字

data_stream.dataset

数据流数据集名称。

constant_keyword

data_stream.namespace

数据流命名空间。

constant_keyword

data_stream.type

数据流类型。

constant_keyword

event.dataset

事件数据集

constant_keyword

event.module

事件模块

constant_keyword

geo.city_name

城市名称。

关键字

geo.continent_name

大洲名称。

关键字

geo.country_iso_code

国家/地区 ISO 代码。

关键字

geo.country_name

国家/地区名称。

关键字

geo.location

经度和纬度。

geo_point

geo.name

用户定义的位置描述，粒度级别取决于用户关心程度。可以是他们的数据中心名称、楼层号（如果描述的是本地物理实体）、城市名称。通常不用于自动地理定位。

关键字

host.containerized

主机是否是容器。

布尔值

host.os.build

操作系统构建信息。

关键字

host.os.codename

操作系统代号（如果有）。

关键字

变更日志

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

1.20.1

错误修复 (查看拉取请求)
修复无痛脚本中的字符串文字。

8.13.0 或更高版本

1.20.0

增强 (查看拉取请求)
添加 Azure 日志集成 v2（预览版）

8.13.0 或更高版本

1.19.4

错误修复 (查看拉取请求)
修复 destination.geo.region_name 映射。

8.13.0 或更高版本

1.19.3

错误修复 (查看拉取请求)
将 Identity 字段重命名为 identity 以保持一致性。

8.13.0 或更高版本

1.19.2

错误修复 (查看拉取请求)
将 properties 字段重命名为 properties.raw，以避免当 properties 字段包含字符串时出现解析错误。

8.13.0 或更高版本

1.19.1

错误修复 (查看拉取请求)
修复错误并澄清有关存储帐户容器的文档。

8.13.0 或更高版本

1.18.0

增强 (查看拉取请求)
将实体标识符添加到 related.entity。

8.13.0 或更高版本

1.17.0

增强 (查看拉取请求)
为与防火墙规则匹配的请求中找到的精确数据添加 event.reason 日志字段。

8.13.0 或更高版本

1.16.0

增强 (查看拉取请求)
允许 @custom 管道访问 event.original，而无需设置 preserve_original_event。

8.13.0 或更高版本

1.15.1

错误修复 (查看拉取请求)
修复 [client|source].geo.location ECS 字段映射

8.13.0 或更高版本

1.15.0

增强 (查看拉取请求)
在 Azure Functions 托管计划中添加新部分。

8.13.0 或更高版本

1.14.0

增强 (查看拉取请求)
为仪表板添加全局数据集筛选器以提高性能。

8.13.0 或更高版本

1.13.1

增强 (查看拉取请求)
使用有关事件中心分区配置的更多详细信息扩展文档。

8.13.0 或更高版本

1.13.0

增强 (查看拉取请求)
向 Azure 防火墙添加结构化日志类别。

8.13.0 或更高版本

1.12.0

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

重大更改 (查看拉取请求)
将“event.outcome”值从“Succeeded”更新为“success”，并将“Failed”更新为“failure”。

8.13.0 或更高版本

1.11.4

错误修复 (查看拉取请求)
将 Azure AD 替换为 Microsoft Entra ID。

8.12.0 或更高版本

1.11.3

错误修复 (查看拉取请求)
更新 Azure 审核日志管道，以支持 initiated_by 用户字段。

8.12.0 或更高版本

1.11.2

错误修复 (查看拉取请求)
添加缺少的 ECS 字段定义。

8.12.0 或更高版本

1.11.1

增强 (查看拉取请求)
更新事件中心参数名称建议的描述。

8.12.0 或更高版本

1.11.0

增强 (查看拉取请求)
为事件中心使用 event.dataset 字段的 ecs 定义

8.12.0 或更高版本

1.10.0

增强 (查看拉取请求)
添加 Microsoft Graph 活动日志

8.12.0 或更高版本

1.9.2

增强 (查看拉取请求)
添加有关在防火墙后运行集成的文档。

8.12.0 或更高版本

1.9.1

Bug 修复 (查看拉取请求)
在密钥字段上将字段类型设置为密码。

8.12.0 或更高版本

1.9.0

增强 (查看拉取请求)
添加对集成密钥的支持

8.12.0 或更高版本

1.8.3

增强 (查看拉取请求)
在 Azure 登录日志的管道中添加 caller_ip_address 字段。

8.8.0 或更高版本

1.8.2

增强 (查看拉取请求)
更新 Azure 日志文档。

8.8.0 或更高版本

1.8.1

增强 (查看拉取请求)
更新 AD 日志文档。

8.8.0 或更高版本

1.8.0

增强 (查看拉取请求)
允许将 Azure 日志事件重新路由到不同的数据流。

8.8.0 或更高版本

1.7.0

增强 (查看拉取请求)
将 Azure Spring Cloud Logs 品牌重塑为 Azure Spring Apps

8.6.0 或更高版本

1.6.0

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

8.6.0 或更高版本

1.5.33

Bug 修复 (查看拉取请求)
在应用程序网关日志中，将 json.properties.clientIp 作为 json.properties.clientIP 的别名处理

8.6.0 或更高版本

1.5.32

Bug 修复 (查看拉取请求)
修复 azure.activitylogs.claims.* 的映射。

8.6.0 或更高版本

1.5.31

增强 (查看拉取请求)
将 Azure AD Identity Protection 仪表板迁移到 Lens。

8.6.0 或更高版本

1.5.30

增强 (查看拉取请求)
将 Azure AD Provisioning Logs 仪表板迁移到 Lens。

8.6.0 或更高版本

1.5.29

增强 (查看拉取请求)
修复 Azure 仪表板描述和标题。

8.6.0 或更高版本

1.5.28

增强 (查看拉取请求)
将警报概览仪表板迁移到 Lens

8.6.0 或更高版本

1.5.27

Bug 修复 (查看拉取请求)
修复防火墙仪表板

8.6.0 或更高版本

1.5.26

Bug 修复 (查看拉取请求)
处理 signinlogs 日志中重复的 user_agent.original 字段

8.6.0 或更高版本

1.5.25

Bug 修复 (查看拉取请求)
处理应用程序网关日志中重复的 url.path 字段

8.6.0 或更高版本

1.5.24

Bug 修复 (查看拉取请求)
处理具有属性的 DNAT 请求的防火墙事件

8.6.0 或更高版本

1.5.23

增强 (查看拉取请求)
更新 Azure 日志屏幕截图

8.6.0 或更高版本

1.5.22

增强 (查看拉取请求)
将 Azure Cloud Overview 仪表板迁移到 Lens 并进行样式更改

8.6.0 或更高版本

1.5.21

增强 (查看拉取请求)
将用户活动仪表板迁移到 Lens

8.6.0 或更高版本

1.5.20

增强 (查看拉取请求)
集成设置 UI，用于清理

8.6.0 或更高版本

1.5.17

增强 (查看拉取请求)
将 Spring Cloud Overview 仪表板迁移到 Lens

8.6.0 或更高版本

1.5.16

增强 (查看拉取请求)
将 Azure Spring Cloud Logs 应用程序云日志仪表板迁移到 Lens

8.6.0 或更高版本

1.5.15

增强 (查看拉取请求)
将 Spring Cloud System Logs 仪表板迁移到 Lens

8.6.0 或更高版本

1.5.14

增强 (查看拉取请求)
增强/提高仪表板的性能

8.6.0 或更高版本

1.5.13

增强 (查看拉取请求)
扩展存储帐户容器文档，并添加指向要求和设置说明的链接

7.16.0 或更高版本
8.0.0 或更高版本

1.5.12

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

7.16.0 或更高版本
8.0.0 或更高版本

1.5.11

增强 (查看拉取请求)
为 AzureFirewallNetworkRule 日志类别添加新的消息格式

7.16.0 或更高版本
8.0.0 或更高版本

1.5.10

Bug 修复 (查看拉取请求)
检查应用程序网关和事件中心摄取管道中是否已存在 *event.original*

7.16.0 或更高版本
8.0.0 或更高版本

1.5.9

Bug 修复 (查看拉取请求)
检查防火墙日志摄取管道中是否已存在 *event.original*

7.16.0 或更高版本
8.0.0 或更高版本

1.5.8

Bug 修复 (查看拉取请求)
向应用程序网关集成添加 storage_account_container 选项

7.16.0 或更高版本
8.0.0 或更高版本

1.5.7

Bug 修复 (查看拉取请求)
修复登录日志中 authentication_processing_details 字段的解析

7.16.0 或更高版本
8.0.0 或更高版本

1.5.6

Bug 修复 (查看拉取请求)
修复客户端端口为空时的解析错误，并调整时间戳

7.16.0 或更高版本
8.0.0 或更高版本

1.5.5

Bug 修复 (查看拉取请求)
当值是字符串时，将 identity 重命名为 identity_name

7.16.0 或更高版本
8.0.0 或更高版本

1.5.4

增强 (查看拉取请求)
默认启用事件中心集成并改进文档

7.16.0 或更高版本
8.0.0 或更高版本

1.5.3

增强 (查看拉取请求)
在新安装中，数据流开始时处于禁用状态

7.16.0 或更高版本
8.0.0 或更高版本

1.5.2

Bug 修复 (查看拉取请求)
修复变更日志中的 PR 链接

7.16.0 或更高版本
8.0.0 或更高版本

1.5.1

Bug 修复 (查看拉取请求)
修复文档格式 (删除额外的 *Overview* 标题)

7.16.0 或更高版本
8.0.0 或更高版本

1.5.0

增强 (查看拉取请求)
添加 Azure 应用程序网关数据流

7.16.0 或更高版本
8.0.0 或更高版本

1.4.1

增强 (查看拉取请求)
更新 Azure 日志文档

7.16.0 或更高版本
8.0.0 或更高版本

1.4.0

增强 (查看拉取请求)
向 Azure AD 日志集成添加两个新的数据流：Azure Identity Protection 日志和 Provisioning 日志

7.16.0 或更高版本
8.0.0 或更高版本

1.3.0

增强 (查看拉取请求)
添加覆盖默认生成的存储帐户容器的可能性

7.16.0 或更高版本
8.0.0 或更高版本

1.2.3

增强 (查看拉取请求)
使用推荐的事件中心配置更新文档

7.16.0 或更高版本
8.0.0 或更高版本

1.2.2

增强 (查看拉取请求)
更新包名称和描述以与标准措辞保持一致

7.16.0 或更高版本
8.0.0 或更高版本

1.2.1

Bug 修复 (查看拉取请求)
修复 Azure 登录日志摄取管道错误

7.16.0 或更高版本
8.0.0 或更高版本

1.2.0

增强 (查看拉取请求)
支持 Azure 防火墙日志

—

1.1.11

Bug 修复 (查看拉取请求)
改进对来自上游转发器的 event.original 字段的支持。

—

1.1.10

增强 (查看拉取请求)
更新自述文件，添加指向 Microsoft 文档的链接

7.16.0 或更高版本
8.0.0 或更高版本

1.1.9

错误修复 (查看拉取请求)
改进 IPv6 IP 地址的处理。

—

1.1.8

增强 (查看拉取请求)
更新文档，添加关于事件中心名称建议的详细信息

7.16.0 或更高版本
8.0.0 或更高版本

1.1.7

错误修复 (查看拉取请求)
在 platformlogs 中添加 geo.name 和 result_description 字段

7.16.0 或更高版本
8.0.0 或更高版本

1.1.6

错误修复 (查看拉取请求)
使用具体的值修复 azure.activitylogs.identity

错误修复 (查看拉取请求)
将 identity_name、tenant_id、level 和 operation_version 添加到活动日志中

7.16.0 或更高版本
8.0.0 或更高版本

1.1.5

增强 (查看拉取请求)
为多字段添加文档

—

1.1.4

错误修复 (查看拉取请求)
修复所有 Azure 数据流中 event.duration 字段映射冲突。

—

1.1.3

增强 (查看拉取请求)
默认将 forwarded 标签添加到所有日志类型。

—

1.1.2

错误修复 (查看拉取请求)
添加 device_detail.is_compliant 和 device_detail.is_managed 字段

错误修复 (查看拉取请求)
将 authentication_requirement_policies 更改为扁平类型

7.16.0 或更高版本
8.0.0 或更高版本

1.1.1

错误修复 (查看拉取请求)
修复审计日志数据流中 client.ip 的字段映射冲突。 将 eventhub 数据流中的 azure-eventhub.offset 和 azure-eventhub.sequence_number 从关键字更改为 long。

—

1.1.0

增强 (查看拉取请求)
支持新的 Azure 审计日志和登录日志

—

1.0.1

增强 (查看拉取请求)
从数据流中删除 beta 版本标签

7.16.0 或更高版本
8.0.0 或更高版本

1.0.0

增强 (查看拉取请求)
将 azure 包移至 GA

7.16.0 或更高版本
8.0.0 或更高版本

0.12.3

增强 (查看拉取请求)
更新到 ECS 8.0

—

0.12.2

错误修复 (查看拉取请求)
使用新的 GeoIP 数据库重新生成测试文件

—

0.12.1

错误修复 (查看拉取请求)
将测试公共 IP 更改为受支持的子集

—

0.12.0

增强 (查看拉取请求)
发布适用于 v8.0.0 的 azure 包

—

0.11.0

增强 (查看拉取请求)
添加 Azure 事件中心输入

—

0.10.1

增强 (查看拉取请求)
符合指南

—

0.10.0

增强 (查看拉取请求)
signinlogs - 添加对 ManagedIdentitySignInLogs、NonInteractiveUserSignInLogs 和 ServicePrincipalSignInLogs 的支持。

—

0.9.2

错误修复 (查看拉取请求)
防止管道脚本错误

—

0.9.1

错误修复 (查看拉取请求)
修复检查 forwarded 标签的逻辑

—

0.9.0

增强 (查看拉取请求)
更新到 ECS 1.12.0

—

0.8.6

错误修复 (查看拉取请求)
添加 ECS client.ip 映射

—

0.8.5

增强 (查看拉取请求)
更新文档和徽标

—

0.8.4

增强 (查看拉取请求)
转换为生成的 ECS 字段

—

0.8.3

增强 (查看拉取请求)
从 ECS 导入 geo_points

—

0.8.2

增强 (查看拉取请求)
更新错误消息

—

0.8.1

增强 (查看拉取请求)
在 platformlogs 管道中添加对 springcloud 日志的支持

—

0.8.0

增强 (查看拉取请求)
导入 ECS 字段定义

—

0.7.0

增强 (查看拉取请求)
添加 spring cloud 日志

—

0.6.2

增强 (查看拉取请求)
更新到 ECS 1.11.0

—

0.6.1

增强 (查看拉取请求)
在文档中转义特殊字符

—

0.6.0

增强 (查看拉取请求)
更新集成描述

—

0.5.1

增强 (查看拉取请求)
重新添加针对无效 json 的管道更改

—

0.5.0

增强 (查看拉取请求)
添加输入组

—

0.4.0

增强 (查看拉取请求)
设置“event.module”和“event.dataset”

—

0.3.1

增强 (查看拉取请求)
将包与模块更改同步

—

0.3.0

增强 (查看拉取请求)
更新到 ECS 1.10.0 并添加 event.original 选项

—

0.2.3

增强 (查看拉取请求)
更新到 ECS 1.9.0

—

0.2.2

错误修复 (查看拉取请求)
更正示例事件文件。

—

0.2.1

错误修复 (查看拉取请求)
添加对空配置选项的检查。

—

0.2.0

增强 (查看拉取请求)
添加更改以使用 ECS 1.8 字段。

—

0.0.1

增强 (查看拉取请求)
初始版本

—
« Azure 资源指标集成 Azure 存储帐户集成 »