Google Cloud Logging将Python logging.info日志标记为ERROR的问题咨询

我首次使用Google Cloud Platform（GCP）搭建调度工作流运行Batch任务，任务中的Python代码使用标准logging库记录日志。任务执行后，日志可正常出现在Cloud Logging中，但所有原本为INFO级别的日志条目均被标记为ERROR级别。

我猜测可能的原因是未按照文档使用setup_logging函数，但我不希望在本地运行代码时执行Cloud Logging的配置操作。我的疑问如下：

1. 未使用setup_logging函数时，日志为何仍能进入Cloud Logging？该函数的实际作用是什么？
2. 为何我的INFO级日志会显示为ERROR级别？
3. 若使用该代码段可解决问题，是否需要添加判断逻辑，在本地运行时跳过Cloud Logging的配置步骤？

1. 日志无需setup_logging也能进入Cloud Logging的原因及该函数作用 #

GCP Batch环境会自动捕获容器或虚拟机的标准输出（stdout）、标准错误（stderr）流，将这些内容直接转发到Cloud Logging，这是平台层面的默认行为，和代码里是否配置Cloud Logging SDK无关。

setup_logging是Cloud Logging Python SDK提供的工具函数，核心作用是：

• 将Python标准logging库的日志直接通过Cloud Logging API上传，而非依赖平台的标准流转发
• 自动处理日志级别与Cloud Logging的映射，确保级别显示准确
• 支持结构化日志格式，自动添加GCP资源元数据（如项目ID、实例ID），方便后续日志检索和分析

2. INFO日志被标记为ERROR级别的原因 #

问题出在Pythonlogging模块的默认配置：默认的StreamHandler会将所有级别的日志输出到标准错误流（stderr），而GCP平台默认将stderr中的所有内容统一标记为ERROR级别上传到Cloud Logging。

也就是说，你的INFO日志其实是从stderr流被捕获的，所以被Cloud Logging错误归类为ERROR级别。

3. 需要添加本地运行的判断逻辑 #

必须加。因为setup_logging是针对GCP环境的配置，本地运行时如果没有正确的GCP身份认证，或者不需要将日志上传到云端，直接调用该函数会导致初始化失败，或者误将本地日志传到Cloud Logging。

可以通过检查环境变量或文件路径判断是否处于GCP环境，示例代码如下：

import logging
import os
from google.cloud.logging import Client

def setup_logging():
    # 检查是否存在GCP项目环境变量（GCP环境会自动注入）
    if os.getenv("GOOGLE_CLOUD_PROJECT"):
        client = Client()
        client.setup_logging()
    else:
        # 本地运行时的日志配置
        logging.basicConfig(
            level=logging.INFO,
            format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
            handlers=[logging.StreamHandler()]
        )

# 初始化日志配置
setup_logging()
logger = logging.getLogger(__name__)

logger.info("这是一条INFO级日志")
logger.error("这是一条ERROR级日志")

这样既保证了GCP环境下日志级别正确映射，本地运行时也能正常输出符合预期的日志，不会触发Cloud Logging的配置流程。

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