云字段用法和示例

编辑

本页涵盖以下主题。

字段重用
编辑

云字段可用于 * 描述事件来源的云资源 * 或 描述与观察到的服务或资源存在直接调用关系的外部云资源的上下文

事件根部的云字段
编辑

使用事件根部的云字段来描述事件主要关联的云资源。此用例的一个示例是为部署在云环境中的服务记录的日志条目。

{
  "cloud": {
    "provider": "aws",
    "region": "us-east-1",
    "service": { "name": "ec2" }
  }
}
在调用关系中描述外部云资源
编辑

托管云服务可能与观察到的服务(即捕获相应事件的服务)存在调用关系。例如,在 AWS Lambda 上运行的观察到的服务可以通过 AWS API Gateway 被调用。另一个示例是观察到的服务调用外部云服务(例如 AWS Simple Email Service)。在调用关系的上下文中,云字段可以分别嵌套在 cloud.origin.*cloud.target.* 下,以从观察到的服务的角度捕获源或目标云服务上的云上下文。此概念类似于 服务字段在 service.origin.*service.target.* 下的嵌套

让我们考虑一个示例事件,该事件表示来自 AWS API Gateway 的入站 AWS Lambda 调用。使用以下 cloud.origin.* 嵌套来描述 API Gateway 服务(从 AWS Lambda 服务的角度来看)

{
  "service": { 
    "name": "MyLambdaFunction",
    "version": "1.0.0",
    "origin": { 
      "name": "MyGateway",
      "version" "2.0",
    }
  },
  "cloud": { 
    "provider": "aws",
    "region": "us-east-1",
    "service": { "name": "lambda" },
    "origin": { 
      "provider": "aws",
      "region": "eu-west-1",
      "service": { "name": "apigateway" }
    }
  }
}

描述观察到的 AWS Lambda 函数

描述入站请求来自的 API Gateway 服务

描述观察到的 AWS Lambda 函数的云上下文

描述入站请求来自的 API Gateway 服务的云上下文

请注意,cloud.origin.*cloud.target.* 字段应仅用于表示调用关系的事件。