MCP Server Google Logging

🚀 日志获取工具项目

本项目旨在帮助用户利用 gcloud CLI 获取项目相关的日志信息，解决不同文脉下日志输出方式和领域知识差异的问题，提供便捷的日志管理功能。

🚀 快速开始

前提条件

• 能够使用 gcloud CLI
• 已经登录到 gcloud 账户
• 具备 IAM 权限

要求

• 以 YAML 格式返回 --> --format yaml
• 日志内容应为基本必要信息（可调整查询），包含内容、资源名称、时间戳
• 启动参数：项目 ID

✨ 主要特性

获取日志的背景

问题

如何获取项目相关的日志信息？YS4B、无印和独栋等不同文脉下，日志输出方式和领域知识各不相同，如何反映这些差异？

创意

• a. 将 gcloud logging 的 MCP Server 设为资源，使其可被获取。这样的话，MCP Server 需要具备一定的业务知识作为前提，如数据库架构、日志、查询技巧等知识，此方案可以接受。
• b. 创建一个专门用于获取其他领域知识的 MCP Server，疏解耦合是一个优点，但管理可能变得复杂。首先尝试 a 方案，将 MCP Server 设为资源以供获取。

资源

• OCPP 相关：事务、状态、连接状态
• 服务相关：预约、使用日志、管理员

局限性

• 无法类似 SELECT 进行过滤

📦 安装指南

此部分文档未提及安装步骤，跳过该章节。

💻 使用示例

运行服务器

可以通过以下方式运行服务器：

node -- /path/to/mcp-server-google-logging/dist/index.js --project=<项目-id>

📚 详细文档

gcloud 功能

日志读取与显示

• 🔵 gcloud logging read - 根据指定的过滤条件获取匹配的日志条目。可以根据资源类型、时间戳、日志级别（severity）等设置条件，甚至可以组合 AND, OR 进行复杂过滤。输出格式可调整为 JSON 或表格形式等，通过 gcloud 的标准选项实现。

实时日志监控

• ❌ gcloud logging tail - 可以实时追踪日志的写入情况。

日志列表查看与管理

• gcloud logging logs list - 列出项目内的所有日志。
• ❌ gcloud logging logs delete - 可以删除不必要的日志。但需注意，此操作不可逆。

日志存储桶管理

• gcloud logging buckets list - 显示日志存储的存储桶列表。
• gcloud logging buckets describe / update - 查看各存储桶的详细信息或调整保留期限等设置。

日志导出管理

• gcloud logging sinks list - 显示将日志自动导出到 Cloud Storage、BigQuery、Pub/Sub 等外部位置的目标（导出目标）列表。
• gcloud logging sinks create / update / delete - 创建新的导出口，或修改现有导出口的设置，删除不再需要的导出口。

基于日志的指标管理

• gcloud logging metrics list - 列出基于日志创建的所有指标。
• gcloud logging metrics create / update / delete - 根据特定的日志条件创建、修改或删除指标。通过这些指标，可以用于监控和设置警报触发。

相关信息

gcloud CLI 用于日志条目的写入与查询