🚀 日志获取工具项目
本项目旨在帮助用户利用 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 - 根据特定的日志条件创建、修改或删除指标。通过这些指标，可以用于监控和设置警报触发。