{
  "markdown": "# Google Cloud Observability Extension for Gemini CLI ☁️\n\nThis extension connects [Gemini CLI](https://github.com/google-gemini/gemini-cli)\nto Cloud Observability APIs with an \n[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server to \nsearch for logs, view metrics, return traces and view\nerror reports. It acts as a local bridge, translating natural language commands\nfrom your CLI into the appropriate API calls to help you **understand, manage,\nand troubleshoot** your Google Cloud environment.\n\n> To learn more about the underlying services, see the official documentation:\n>\n> -   [Cloud Logging](https://cloud.google.com/logging/docs)\n> -   [Cloud Monitoring](https://cloud.google.com/monitoring/docs)\n> -   [Cloud Trace](https://cloud.google.com/trace/docs)\n> -   [Error Reporting](https://cloud.google.com/error-reporting/docs)\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n-   [Node.js](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm):\n    version 20 or higher\n-   [gcloud CLI](https://cloud.google.com/sdk/docs/install)\n\n## ✨ Install the extension\n\n### Gemini CLI and Gemini Code Assist\n\nTo integrate this extension with Gemini CLI or Gemini Code Assist, run the setup\ncommand below. This will install the MCP server as a\n[Gemini CLI extension](https://github.com/google-gemini/gemini-cli/blob/main/docs/extension.md)\nfor the current user, making it available for all your projects. Refer to \n[Gemini CLI extension management](https://github.com/google-gemini/gemini-cli/blob/main/docs/extension.md#extension-management)\nfor uninstall, disable, enable, and update instructions.\n\n```shell\ngemini extensions install https://github.com/gemini-cli-extensions/observability\n```\n\nAfter the initialization process, you can verify that the observability-mcp server is\nconfigured correctly by running the following command:\n\n```\ngemini mcp list\n\n> ✓ observability: npx -y @google-cloud/observability-mcp (stdio) - Connected\n```\n\n### For other AI clients\n\nSee github.com/googleapis/gcloud-mcp for instructions on using the Cloud Observability MCP\nserver with other AI clients.\n\n### Authentication\n\nYou need to authenticate twice: once for your user account and once for the\napplication itself.\n\n```shell\n# Authenticate your user account to the gcloud CLI\ngcloud auth login\n\n# Set up Application Default Credentials for the server.\n# This allows the MCP server to securely make Google Cloud API calls on your behalf.\ngcloud auth application-default login\n```\n\n#### Setting the Quota Project\n\nAll API requests made by this server require a Google Cloud project for billing\nand API quota management. This is known as the \"quota project\". This project\nwill likely already be set in the gcloud CLI. The project selected as the quota\nproject will need to have the APIs you wish to use in Observability **enabled**\nor you will see errors when attempting to use their related tools (e.g. you need\nthe Cloud Logging API enabled in the quota project to use the list_log_entries\ntool).\n\nIf you need to control which project is used for quotas, run the following\ncommand\n(https://cloud.google.com/sdk/gcloud/reference/auth/application-default/set-quota-project):\n\n```shell\n# Set the project to be used for API quotas and billing by ADC\ngcloud auth application-default set-quota-project YOUR_QUOTA_PROJECT_ID\n```\n\nThis ensures that all API usage from this server is attributed to the correct\nproject.\n\n## Usage\n\nOnce the server is configured, you can ask your MCP client natural language\nquestions about your Google Cloud environment. Here are a few examples:\n\n-   **\"Show me all logs with a severity of ERROR.\"**\n-   **\"What is the average CPU utilization for my GCE instances over the last\n    hour?\"**\n-   **\"List all traces from the past 30 minutes.\"**\n-   **\"Are there any new stack traces in my logs in the last day?\"**\n\nYour MCP client will translate these questions into the appropriate tool calls\nto fetch the data from Google Cloud.\n\n## Tools Reference\n\nThe server exposes the following tools:\n\n| Service             | Tool                      | Description                |\n| ------------------- | ------------------------- | -------------------------- |\n| **Logging**         | `list_log_entries`        | Lists log entries from a project. |\n|                     | `list_log_names`          | Lists log names from a project. |\n|                     | `list_buckets`            | Lists log buckets from a project. |\n|                     | `list_views`              | Lists log views from a project. |\n|                     | `list_sinks`              | Lists log sinks from a project. |\n|                     | `list_log_scopes`         | Lists log scopes from a project. |\n| **Monitoring**      | `list_metric_descriptors` | Lists metric descriptors for a project. |\n|                     | `list_time_series`        | Lists time series data for a given metric. |\n|                     | `list_alert_policies`     | Lists the alert policies in a project. |\n| **Trace**           | `list_traces`             | Searches for traces in a project. |\n|                     | `get_trace`               | Gets a specific trace in a project. |\n| **Error Reporting** | `list_group_stats`        | Lists the error groups for a project. |\n\n## 🛡️ Important Notes\n\nThis repository is currently in prerelease and may see breaking changes until\nthe first stable release (v1.0).\n\nThis repository is providing a solution, not an officially supported Google\nproduct. It may break when the MCP specification, other SDKs, or when other\nsolutions and products change.\n\n## 👥 Contributing\n\nPlease read our [Contributing Guide](../../CONTRIBUTING.md) to get started.\n\n## 📝 License\n\nThis project is licensed under the Apache 2.0 License - see the\n[LICENSE](../../LICENSE) file for details.\n",
  "bytes": 5803,
  "sha": "a502650b5344d6652cd0fb9de8df8e39d85defb4be6e8ec43e553a97e8df7b2d",
  "repo_slug": "gemini-cli-extensions/observability",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_gemini_cli_extensions_observability_74d0f663/readme"
}