设置 Go 版 Stackdriver Logging

我们提供了与库兼容的标准日志记录软件包。Go 版 Stackdriver Logging 库提供了一个更高级别的层，用于处理 Stackdriver Logging。

无需安装 Stackdriver Logging 代理即可在 Compute Engine 虚拟机实例上使用 Go 版 Stackdriver Logging 库。

准备工作

1. 登录您的 Google 帐号。

   如果您还没有 Google 帐号，请注册新帐号。

2. 选择或创建 Google Cloud Platform 项目。

   注意：如果您不打算保留在本教程中创建的资源，请创建一个新项目，而不是选择现有项目。完成本教程后，您可以删除所创建的项目，从而移除与该项目和教程关联的所有资源。

   转到“管理资源”页面

3. 确保您的 Google Cloud Platform 项目已启用结算功能。

   了解如何启用结算功能

4. 启用Stackdriver Logging API。

   启用 API

安装软件包

go get -u cloud.google.com/go/logging

使用 Go 日志记录器

在 GitHub 上查看 反馈

// Sample stdlogging writes log.Logger logs to the Stackdriver Logging.
package main

import (
	"log"

	// Imports the Stackdriver Logging client package.
	"cloud.google.com/go/logging"
	"golang.org/x/net/context"
)

func main() {
	ctx := context.Background()

	// Sets your Google Cloud Platform project ID.
	projectID := "YOUR_PROJECT_ID"

	// Creates a client.
	client, err := logging.NewClient(ctx, projectID)
	if err != nil {
		log.Fatalf("Failed to create client: %v", err)
	}
	defer client.Close()

	// Sets the name of the log to write to.
	logName := "my-log"

	logger := client.Logger(logName).StandardLogger(logging.Info)

	// Logs "hello world", log entry is visible at
	// Stackdriver Logs.
	logger.Println("hello world")
}

如需详细了解如何安装，请参阅 Go 版 Stackdriver Logging 库的文档。您还可以使用问题跟踪器来报告问题。

直接使用 Cloud 客户端库

如需了解如何直接使用 Go 版 Stackdriver Logging Cloud 客户端库，请参阅 Stackdriver Logging 客户端库。

在 Google Cloud Platform 上运行

要使用 Go 版 Stackdriver Logging 库，您需要具有 GCP 的 Cloud IAM Logs Writer 角色。大多数 GCP 环境默认提供此角色。

App Engine

App Engine 默认授予 Logs Writer 角色。

无需明确提供凭据即可使用 Go 版 Stackdriver Logging 库。

系统会自动为 App Engine 应用启用 Stackdriver Logging。无需进行额外设置。

注意：写入 stdout 和 stderr 的日志会自动发送到 Stackdriver Logging，而无需使用 Go 版 Stackdriver Logging 库。

Google Kubernetes Engine

在 Google Kubernetes Engine 上，您必须在创建集群时添加 logging.write 访问权限范围：

gcloud container clusters create example-cluster-name --scopes https://www.googleapis.com/auth/logging.write

Compute Engine

注意：要在 Compute Engine 虚拟机实例上使用 Go 版 Stackdriver Logging 库，您无需安装 Stackdriver Logging 代理。

使用 Compute Engine 虚拟机实例时，请为每个实例添加 cloud-platform 访问权限范围。通过 Google Cloud Platform Console 创建新实例时，您可以在创建实例面板的身份和 API 访问权限部分中执行此操作。请使用 Compute Engine 默认服务帐号或所选的其他服务帐号，并在身份和 API 访问权限部分中勾选允许所有 Cloud API 的全面访问权限。无论您选择哪个服务帐号，都请确保已在 GCP Console 的 IAM 和管理部分中向该服务帐号授予 Logs Writer 角色。

在本地和其他位置运行

要在 Google Cloud Platform 之外（包括您自己的工作站、您数据中心的计算机或另一家云提供商的虚拟机实例上）使用 Go 版 Stackdriver Logging 库，您必须直接向 Go 版 Stackdriver Logging 库提供您的 GCP 项目 ID 和相应的服务帐号凭据。

您可以手动创建和获取服务帐号凭据。指定角色字段时，请使用 Logs Writer 角色。要详细了解 Cloud Identity and Access Management 角色，请转到访问控制指南。

查看日志

部署后，您可以在 GCP Console 日志查看器中查看日志。

转到“日志查看器”

在“日志查看器”中，您必须指定一个或多个资源，但资源的选择并不那么显而易见。以下是帮助您上手的一些提示：

• 如果您将把应用部署到 App Engine 或者您使用的是 App Engine 专用的库，请将资源设置为 GAE 应用。

• 如果您将在 Compute Engine 上部署应用，请将资源设置为 GCE 虚拟机实例。

• 如果您将在 Google Kubernetes Engine 上部署应用，则集群的日志记录配置将确定日志条目的资源类型。如需关于旧版 Stackdriver 和 Stackdriver Kubernetes Monitoring 解决方案以及这些选项如何影响资源类型的详细讨论，请参阅迁移到 Stackdriver Kubernetes Monitoring。

• 如果您的应用直接使用 Stackdriver Logging API，则资源依赖于该 API 和您的配置。例如，在您的应用中，您可以指定资源或使用默认资源。

• 如果您在“日志查看器”中没有看到任何日志，要查看所有日志条目，请切换到高级过滤条件模式并使用空过滤条件。

  1. 要切换到高级过滤条件模式，请点击“日志查看器”顶部的菜单 (＆blacktriangledown;)，然后选择转换为高级过滤条件。
  2. 清除过滤条件框中显示的内容。
  3. 点击提交过滤条件。

  您可以检查各个条目以识别您的资源。

如需了解其他信息，请参阅查看日志和高级日志过滤条件。