为 Logging 配置默认资源设置

本文档介绍如何使用 Google Cloud CLI 配置 Logging 的默认资源设置。

概览

组织资源位于 Google Cloud 资源层次结构的最高层。组织资源是以下子资源的父资源:Cloud 项目、文件夹、结算帐号(对于 Logging,则称为存储分区)。

您可以为 Google Cloud 组织配置默认资源设置,以便组织及其所有新的子资源继承以下条件:

准备工作

如需开始为组织配置默认设置,请执行以下操作:

指定存储区域

日志存储分区是 Cloud 项目、结算帐号、文件夹和组织中用于存储和整理日志数据的容器。对于每个 Cloud 项目、结算帐号、文件夹和组织,Logging 都会自动创建两个日志存储分区:_Required_Default,它们会自动存储在未指定的 global 位置。

您可以为组织包含的 _Required_Default 存储分区指定不同的存储位置。如需查看支持的存储位置的列表,请参阅数据区域性:支持的区域

您更改的任何默认设置只会应用于配置完成后创建的资源;新设置不会应用于组织中已存在的资源。为组织配置默认存储区域后,会出现以下情况:

  • 该组织中的现有 _Required_Default 存储分区会保留创建它们时为其分配的存储区域。

  • 对于在配置默认区域后在组织中创建的任何新 Cloud 项目、结算帐号或文件夹,它们的 _Required_Default 存储分区会继承默认存储区域。

如需为组织及其子资源包含的 _Required_Default 存储分区指定存储位置,请使用 gcloud alpha logging settings update 命令并添加 --organization--storage-location 标志:

gcloud alpha logging settings update --organization=ORGANIZATION_ID --storage-location=LOCATION

在上述命令中,替换变量,如下所示:

  • ORGANIZATION_ID 是指要应用默认设置的 Google Cloud 组织的 ID。如需查找此 ID,请参阅获取组织 ID
  • LOCATION 是指您要存储数据的区域。如需查看支持的存储位置的列表,请参阅数据区域性:支持的区域

如果要查看组织的设置(包括默认存储位置),请使用 gcloud alpha logging settings describe 命令:

gcloud alpha logging settings describe --organization=ORGANIZATION_ID

指定存储位置后,您可以再次使用 gcloud alpha logging settings update 命令并使用新位置更新 --storage-location 标志来进行更改:

gcloud alpha logging settings update --organization=ORGANIZATION_ID --storage-location=NEW_LOCATION

停用 _Default 接收器

Logging 为每个 Cloud 项目、结算帐号、文件夹和组织资源提供预定义的 _Default 接收器。在资源中生成且符合 _Default 接收器的包含条件的任何日志都会路由并存储在资源的预定义名称 _Default 存储分区中。

您可以停用组织的所有 _Default 接收器,以阻止将日志提取到其 _Default 存储分区。如果您停止提取到资源的 _Default 存储分区,则本路由到该存储分区的日志将从 Logging 的存储范围中排除,除非这些日志明确包含在该资源的另一个用户指定的接收器中。

如需为您的组织及其任何子资源停用 _Default 接收器,请使用 gcloud alpha logging settings update 命令并添加 --organization--disable-default-sink 标志:

gcloud alpha logging settings update --organization=ORGANIZATION_ID --disable-default-sink

在上述命令中,将 ORGANIZATION_ID 替换为您要应用默认设置的 Google Cloud 组织的 ID。如需查找此 ID,请参阅获取组织 ID

disable-default-sink 标志仅适用于将日志路由到 _Default 存储分区的 _Default 接收器。

如果您希望查看组织的设置(包括 _Default 接收器是否已停用),请使用 gcloud alpha logging settings describe 命令:

gcloud alpha logging settings describe --organization=ORGANIZATION_ID

如果要重新启用 _Default 接收器,请使用 gcloud alpha logging settings update 命令并添加 --no-disable-default-sink 标志:

gcloud alpha logging settings update --organization=ORGANIZATION_ID --no-disable-default-sink