Lap Amazon Codeguru Profiler — 使用 Amazon CodeGuru Profiler 优化性能

Amazon CodeGuru Profiler API 版本：2019-07-18 Auth：AWS SigV4 Base URL：未指定

设置 配置 Auth：AWS SigV4 GET /internal/findingsReports -- 验证访问 POST /profilingGroups/{profilingGroupName}/notificationConfiguration -- 创建第一个 notificationConfiguration

端点 共 23 个端点，分为 3 组。请参阅 references/api-spec.lap 以获取详细信息。

profilingGroups 方法 路径：POST /profilingGroups/{profilingGroupName}/notificationConfiguration 描述：为一个 profiling group 添加最多 2 个异常通知通道。

路径：POST /profilingGroups/{profilingGroupName}/frames/-/metrics 描述：返回一个时间段内请求的 frame metrics 的时间序列值。

路径：POST /profilingGroups/{profilingGroupName}/configureAgent 描述：由 profiler 代理使用，以报告其当前状态并接收远程配置更新。例如，ConfigureAgent 可用于告诉代理是否要进行 profiling 以及返回 profiling 数据的时间长度。

路径：POST /profilingGroups 描述：创建一个 profiling group。

路径：DELETE /profilingGroups/{profilingGroupName} 描述：删除一个 profiling group。

路径：GET /profilingGroups/{profilingGroupName} 描述：返回一个 ProfilingGroupDescription 对象，该对象包含有关请求的 profiling group 的信息。

路径：GET /profilingGroups/{profilingGroupName}/notificationConfiguration 描述：获取一个 profiling group 的当前异常通知配置。

路径：GET /profilingGroups/{profilingGroupName}/policy 描述：返回一个 profiling group 的 JSON 格式的基于资源的策略。

路径：GET /profilingGroups/{profilingGroupName}/profile 描述：获取一个 profiling group 在指定时间范围内的聚合 profile。Amazon CodeGuru Profiler 将一个 profiling group 的 posted 代理 profile 聚合成聚合 profile。由于聚合 profile 会随时间过期，因此 GetProfile 不是幂等的。使用 1 或 2 个以下参数指定请求的聚合 profile 的时间范围：startTime、endTime、period。允许的最大时间范围为 7 天。如果指定所有 3 个参数，则抛出异常。如果仅指定 period，则返回最新的聚合 profile。聚合 profile 可以在 5 分钟、1 小时和 1 天的聚合周期内获得，且与 UTC 对齐。聚合 profile 的聚合周期决定了它被保留的时间长度。有关更多信息，请参阅 AggregatedProfileTime。聚合 profile 的聚合周期决定了它被 CodeGuru Profiler 保留的时间长度。如果聚合周期为 5 分钟，则聚合 profile 将被保留 15 天。如果聚合周期为 1 小时，则聚合 profile 将被保留 60 天。如果聚合周期为 1 天，则聚合 profile 将被保留 3 年。调用 GetProfile 有两个用例。如果要返回一个已经存在的聚合 profile，请使用 ListProfileTimes 查看现有聚合 profile 的时间范围。然后在 GetProfile 请求中使用它们以返回一个特定的现有聚合 profile。如果要返回一个时间范围不与现有聚合 profile 对齐的聚合 profile，则 CodeGuru Profiler 尽力将请求的时间范围内的现有聚合 profile 组合并返回为一个聚合 profile。如果请求的时间范围内没有聚合 profile，则返回一个较小的时间范围内的聚合 profile。例如，如果请求的时间范围是从 00:00 到 00:20，并且现有的聚合 profile 是从 00:15 和 00:25，则返回从 00:15 到 00:20 的聚合 profile。

路径：GET /profilingGroups/{profilingGroupName}/profileTimes 描述：列出一个 profiling group 在指定时间范围内的聚合周期内的可用聚合 profile 的开始时间。

路径：GET /profilingGroups 描述：返回一个 profiling group 的列表。profiling group 以 ProfilingGroupDescription 对象的形式返回。

路径：POST /profilingGroups/{profilingGroupName}/agentProfile 描述：将 profiling 数据提交到一个 profiling group 的聚合 profile 中。要获取使用此 profiling 数据创建的聚合 profile，请使用 GetProfile。

路径：PUT /profilingGroups/{profilingGroupName}/policy/{actionGroup} 描述：向一个 profiling group 的基于资源的策略中添加权限，使用一个操作组提供。 如果一个 profiling group 没有基于资源的策略，则使用操作组中的权限和 principals 参数中的角色和用户为它创建一个。支持添加的唯一操作组是 agentPermission，它授予 ConfigureAgent 和 PostAgent 权限。有关更多信息，请参阅 Amazon CodeGuru Profiler 用户指南中的 CodeGuru Profiler 中的基于资源的策略、ConfigureAgent 和 PostAgentProfile。第一次调用 PutPermission 时，请不要在一个 profiling group 上指定 revisionId，因为它没有基于资源的策略。随后的调用必须提供 revisionId 以指定要添加到哪个修订版的基于资源的策略中。