Google Cloud Logging 数据源

概述

Google Cloud Logging 数据源是 Grafana 的后端数据源插件，允许用户在 Grafana 中查询和可视化他们的 Google Cloud 日志。

设置

启用 Cloud Resource Manager API

您需要启用 resource manager API。否则，您的云项目将不会显示在下拉菜单中。

您可以按照以下步骤启用它

1. 在 GCP 中导航到 cloud resource manager API 页面并选择您的项目
2. 按下 Enable 按钮

生成 JWT 文件并分配 IAM 权限

1. 如果您没有 gcp 项目，请添加一个新 gcp 项目。 链接
2. 在 Google API 控制台中打开 Credentials 页面
3. 点击 Create Credentials 然后点击 Service account
4. 在 Create service account 页面上，输入 Service account 详细信息
5. 在 Create service account 页面上，填写 Service account details，然后点击 Create and Continue
6. 在 Grant this service account access to project 部分，将 Logs Viewer 角色和 Logs View Accessor 角色（在 Logging 下）添加到服务账户。点击 Done
7. 在下一步中，点击您刚创建的服务账户。在 Keys 选项卡下，选择 Add key 和 Create new key
8. 选择密钥类型 JSON，然后点击 Create。将创建一个 JSON 密钥文件并下载到您的计算机

如果您想访问多个云项目中的日志，您需要确保该服务账户具有读取所有这些项目日志的权限。

如果您在 GCE VM 上托管 Grafana，您也可以使用 Compute Engine 服务账户。您需要确保该服务账户具有足够的权限来访问所有项目中的范围和日志。

服务账户模拟

您还可以配置插件以使用 服务账户模拟。您需要确保此插件使用的服务账户具有 iam.serviceAccounts.getAccessToken 权限。此权限包含在 Service Account Token Creator 角色（roles/iam.serviceAccountTokenCreator）等角色中。此外，此插件模拟的服务账户需要日志读取和项目列表权限。

Grafana 配置

1. Grafana 重启后，导航到 Configuration -> Data sources（或路径 /datasources）
2. 点击“添加数据源”
3. 选择“Google Cloud Logging”
4. 在 JWT 文件中提供凭据，可以通过文件选择器或粘贴文件内容的方式。
5. 点击“保存并测试”，以测试是否可以从 Cloud Logging 查询日志。

配置数据源的另一种方法

插件安装后，您可以将数据源定义和配置在 YAML 文件中，作为 Grafana 配置系统的一部分，类似于 Google Cloud Monitoring 插件。有关配置的更多信息以及可用的配置选项，请参阅 配置 Grafana。

以下 YAML 是一个示例。

apiVersion: 1
datasources:

name: Google Cloud Logging
type: googlecloud-logging-datasource
access: proxy
jsonData:
authenticationType: gce

支持的变量

该插件目前支持 logging scopes 的变量。例如，您可以定义一个项目变量并在项目之间切换。以下截图显示了使用项目、桶和视图的示例。

下面是一个定义日志视图变量的示例。

告警

由于 Google Cloud 上 Logging Query Language 的工作方式，Grafana Alerting 不直接支持。如果您需要基于日志创建告警，请考虑使用 Log-based metrics 和 Cloud Monitoring 数据源。

许可证

Cloud Logging Logo (src/img/logo.svg) 来自 Google Cloud 的 Official icons and sample diagrams

如评论所述，JWTForm 和 JWTConfigEditor 主要基于 Apache-2.0 许可的 grafana-google-sdk-react