如何动态获取AWS Lambda函数的p99执行时间？

我想通过Lambda函数执行时间优化用户体验，搭建了CloudWatch仪表盘来展示各端点的p99执行时间，但不知道怎么获取实际的指标数值。用AWS SDK调用cloudwatch.getDashboard()时，只拿到了仪表盘的指标配置属性，没有具体数据。

当前调用getDashboard()返回的内容示例：

{
  type: 'metric',
  x: 0,
  y: 0,
  width: 6,
  height: 6,
  properties: {
    metrics: [ [Array], [Array], [Array], [Array] ],
    view: 'bar',
    region: 'us-east-1',
    stat: 'p99',
    period: 300,
    title: 'Lambda P99 Execution Time'
  }
}

我需要获取仪表盘展示的底层指标数值，请问是需要额外定义聚合规则，还是可以直接从预定义仪表盘拉取？

核心结论 #

getDashboard()仅返回仪表盘的配置信息（布局、指标定义、可视化设置），不会返回实际的时间序列数据。要获取指标数值，必须使用CloudWatch的getMetricData（推荐）或getMetricStatistics API，直接查询仪表盘配置中定义的指标。

具体步骤 #

1. 从仪表盘配置中提取查询参数
   从getDashboard()返回的properties里提取以下关键信息：

   • metrics：每个数组元素对应一个指标的「命名空间、指标名、维度」，比如Lambda的命名空间是AWS/Lambda，指标名是Duration，维度可能包含FunctionName等。
   • stat：仪表盘指定的统计量（这里是p99）。
   • period：数据聚合的时间间隔（单位：秒）。
   • region：指标所在的AWS区域。

2. 调用getMetricData查询实际数据
   用提取到的参数构造getMetricData请求，指定时间范围（StartTime和EndTime），即可获取对应指标的数值。

   示例代码（JavaScript SDK v3）：

   import { CloudWatchClient, GetMetricDataCommand } from "@aws-sdk/client-cloudwatch";
   
   const client = new CloudWatchClient({ region: "us-east-1" });
   
   // 从getDashboard结果中提取的metrics数组，展开后格式示例
   const targetMetrics = [
     ["AWS/Lambda", "Duration", "FunctionName", "my-function-1"],
     ["AWS/Lambda", "Duration", "FunctionName", "my-function-2"]
   ];
   
   // 构造MetricDataQueries
   const metricDataQueries = targetMetrics.map((metric, index) => ({
     Id: `m${index+1}`,
     MetricStat: {
       Metric: {
         Namespace: metric[0],
         MetricName: metric[1],
         Dimensions: metric.slice(2).reduce((acc, val, i) => {
           if (i % 2 === 0) acc.push({ Name: val, Value: metric[i+1] });
           return acc;
         }, [])
       },
       Period: 300, // 从properties.period获取
       Stat: "p99" // 从properties.stat获取
     },
     ReturnData: true
   }));
   
   const command = new GetMetricDataCommand({
     MetricDataQueries: metricDataQueries,
     StartTime: new Date(Date.now() - 3600 * 1000), // 过去1小时
     EndTime: new Date()
   });
   
   const response = await client.send(command);
   console.log(response.MetricDataResults); // 包含实际p99数值和时间戳
   

3. 关于聚合规则
   不需要额外定义聚合规则——仪表盘里已经指定了stat（p99）和period，直接复用这些参数即可保证查询结果和仪表盘展示的数据一致。如果需要调整统计方式或时间间隔，再修改对应的参数。

注意事项 #

• 确保StartTime和EndTime覆盖你需要的时间范围，CloudWatch会自动返回该范围内符合period的聚合数据。
• 维度必须和仪表盘配置完全一致，否则查询结果会不匹配。
• getMetricData支持批量查询多个指标，效率比getMetricStatistics更高，适合处理仪表盘里的多个指标。

内容的提问来源于stack exchange，提问作者rotsner