如何通过编程筛选GCP中特定Cloud Function的日志条目？

问题背景 #

我在尝试通过编程方式获取GCP中特定日志条目时遇到困难。我的项目中有多个Cloud Function，它们均将日志写入名为cloudfunctions.googleapis.com%2Fcloud-functions的日志中。

我使用GCP Logging客户端库执行以下代码可成功获取少量日志条目：

const log = logging.log('cloudfunctions.googleapis.com%2Fcloud-functions');
const [entries] = await log.getEntries({
      autoPaginate: false, 
      pageSize: 5
 });

但我现在只想获取其中一个Cloud Function（function-x）的日志条目，尝试使用resourceNames参数时出现报错：

Error: 3 INVALID_ARGUMENT: Received unexpected value parsing name "projects/my-project-id/logs/cloudfunctions.googleapis.com%2Fcloud-functions/function-x": my-project-id. Expected the form projects/[PROJECT_ID]

我的问题是：如何仅获取function-x的日志条目？另外，log.getEntries(query)的filter属性该如何使用？其格式要求是什么？我还希望后续能按标签和日志级别筛选日志。

解决方案 #

1. 筛选特定Cloud Function的日志 #

不需要用resourceNames指定具体函数，直接通过filter属性过滤即可。Cloud Function的日志会携带resource.labels.function_name字段，针对该字段设置过滤条件就能拿到目标函数的日志：

const log = logging.log('cloudfunctions.googleapis.com%2Fcloud-functions');
const [entries] = await log.getEntries({
  autoPaginate: false,
  pageSize: 5,
  filter: 'resource.labels.function_name="function-x"'
});

2. filter属性的格式规则 #

GCP Logging的筛选语法基于日志查询语言，核心规则如下：

• 字段用.层级访问，比如resource.labels.function_name、labels.my_custom_tag
• 字符串值必须用双引号包裹，数值、布尔值直接书写
• 支持逻辑运算符：AND、OR、NOT
• 支持通配符：*（匹配任意长度字符）、?（匹配单个字符）

3. 扩展筛选：按标签和日志级别过滤 #

按自定义标签筛选

如果日志带有自定义标签（比如labels.env="production"），可以叠加过滤条件：

filter: 'resource.labels.function_name="function-x" AND labels.env="production"'

按日志级别筛选

日志级别对应severity字段，可选值包括DEBUG、INFO、WARNING、ERROR、CRITICAL，支持比较运算符：

filter: 'resource.labels.function_name="function-x" AND severity>=WARNING'

关于resourceNames报错的原因 #

resourceNames的合法格式是projects/[PROJECT_ID]，它仅用于指定查询的项目范围，而非具体日志或函数路径。你之前错误地追加了日志和函数后缀，导致格式不符合要求。如果初始化logging客户端时已指定项目，该参数可直接省略；若需显式指定，只需写resourceNames: ['projects/my-project-id']即可。

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