gcp-log

Python库，用于将日志格式化为GCP兼容的JSON。

特性

• 与标准logging库兼容。
• 支持结构化日志的extra。
• 100%与官方规范兼容。
• 非侵入式，不启动任何线程或进程，不进行网络或系统调用。
• 零配置。
• 快速。
• 纯Python。
• 类型安全。
• 无依赖。
• 可选与orjson集成以提高性能。

安装

python3 -m pip install gcp-log

可选：如果您也安装了orjson，gcp-log将自动使用它而不是stdlib json进行更快的序列化

python3 -m pip install orjson

用法

要使用它，只需将gcp_log.Formatter设置为logger的格式化器

import logging
import gcp_log

logger = logging.getLogger()
handler = logging.StreamHandler()
formatter = gcp_log.Formatter()
handler.setFormatter(formatter)
logger.addHandler(handler)

然后您就可以使用logger了

logger.info('aragorn', extra=dict(father='arathorn'))

输出

{"message":"aragorn","severity":"INFO","timestamp":"2022-03-17T10:09:58.393124+00:00Z","logging.googleapis.com/sourceLocation":{"file":"/full/path/to/example.py.py","line":24,"function":"test_gcp_formatter"},"father":"arathorn"}

可读版本

{
    "message": "aragorn",
    "severity": "INFO",
    "timestamp": "2022-03-17T10:09:58.393124+00:00Z",
    "logging.googleapis.com/sourceLocation": {
        "file": "/full/path/to/example.py.py",
        "line": 24,
        "function": "test_gcp_formatter",
    },
    "father": "arathorn",
}