配置日志存储分区

本文档介绍如何使用 Google Cloud 控制台、Google Cloud CLI 和 Logging API 创建和管理 Cloud Logging 存储分区。本页面还提供了在 Google Cloud 项目级别创建和管理日志存储分区的说明。您无法在文件夹或组织级别创建日志存储分区；但是，Cloud Logging 会自动在文件夹和组织级别创建 _Default 和 _Required 存储分区。

您可以升级日志存储分区以使用 Log Analytics。借助日志分析，您可以对日志数据运行 SQL 查询，这有助于你排查应用、安全和网络问题。当日志存储桶升级成使用日志分析之后，以及关联的 BigQuery 数据集也存在时，您还可以使用 BigQuery 查看日志存储桶中存储的数据。通过创建关联的数据集，您可以将日志数据与 BigQuery 中存储的其他数据相联接，并访问 Looker 数据洞察和 Looker 等其他工具中的数据。

如需了解存储桶的概念性概览，请参阅路由和存储概览：日志存储桶。

准备工作

如需开始使用存储桶，请执行以下操作：

• 确保您已为 Google Cloud 项目启用结算功能。

• 确保您的 Identity and Access Management (IAM) 角色向您授予创建、升级和关联存储分区所需的权限。

  Logs Configuration Writer (roles/logging.configWriter) 角色是最小的预定义角色，可授予管理存储分区所需的权限。如需查看权限和角色的完整列表，请参阅使用 IAM 进行访问权限控制。

• 了解 LogBucket 格式要求，包括用于存储日志的支持区域。

• 请考虑设置默认资源位置，以便为组织中的 _Required 和 _Default 存储分区应用默认存储区域。

• 如需使用 BigQuery 查看日志存储桶中存储的数据，请执行以下操作：

  • 确保已启用 BigQuery API。您可以通过列出可用服务来验证该 API 是否已启用。

  • 您的 Identity and Access Management 角色拥有创建关联的数据集的权限。如需了解详情，请参阅关联的 BigQuery 数据集的权限。

• 如需了解如何创建使用客户管理的加密密钥 (CMEK) 的日志存储桶，请参阅为日志存储配置 CMEK。

创建存储桶

每个 Google Cloud 项目最多可以创建 100 个存储分区。

如需为您的 Google Cloud 项目创建用户定义的日志存储桶，请执行以下操作：

Google Cloud 控制台

如需在 Google Cloud 项目中创建日志存储桶，请执行以下操作：

1. 从“日志记录”菜单中选择日志存储。

   前往“日志存储”

2. 点击创建日志存储桶。

3. 输入存储桶的名称和说明。

4. 可选：升级存储桶以使用日志分析。

   警告 ：升级存储桶以使用日志分析是永久性操作。您无法降级日志存储桶以停止使用日志分析。

   1. 选择升级以使用日志分析。

      将存储桶升级为使用 Log Analytics 后，您可以使用 SQL 查询在 Log Analytics 页面中查询日志。您也可以使用日志浏览器继续查看日志。

      并非所有区域都支持 Log Analytics。如需了解详情，请参阅支持的区域。

   2. 可选：如需在 BigQuery 中查看日志，请选择创建新的 BigQuery 数据集，使其链接到此存储桶并输入唯一的数据集名称。

      选择此选项后，BigQuery 可以读取您的日志存储桶中存储的数据。您现在可以在 BigQuery 界面中查询，以联接日志数据，并访问来自 Looker 数据洞察和 Looker 等其他工具的数据。

5. 可选：如需为日志选择存储区域，请点击选择日志存储桶区域菜单，然后选择一个区域。如果您未选择区域，则系统会使用 global 区域，这意味着日志可以实际位于任何区域中。

   注意：创建日志存储桶后，您便无法更改存储桶所在的区域。如果您需要其他地区的存储桶，则必须在该地区中新建一个存储桶，并将相应的接收器重定向到新存储桶，然后删除旧存储桶。

6. 可选：如需为存储桶中的日志设置自定义保留期限，请点击下一步。

   在保留期限字段中，输入您希望 Cloud Logging 保留日志的天数，介于 1 天到 3650 天之间。如果您不自定义保留期限，则默认值为 30 days。

   您还可以在创建存储桶后更新该存储桶，以应用自定义保留功能。

7. 点击创建存储桶。

   选择日志存储桶选项后，Logging 会升级存储桶并创建数据集链接。

   这些步骤可能需要一段时间才能完成。

gcloud

注意 ：创建日志存储桶时，除非使用 Google Cloud 控制台，否则您无法创建关联的 BigQuery 数据集。但是，在创建和升级日志存储桶时，您可以使用 gcloud logging links create 命令方法创建关联的数据集。

若要仅创建日志存储桶，请运行 gcloud logging buckets create 命令。如果您想升级日志存储桶以使用日志分析，请添加 --enable-analytics 和 --async 标志，并确保将变量 LOCATION 设置为日志分析支持的区域：

gcloud logging buckets create BUCKET_ID --location=LOCATION --enable-analytics --async OPTIONAL_FLAGS

--async 标志用于强制运行异步命令。异步方法的返回是一个 Operation 对象，它包含有关方法进度的信息。该方法完成后，Operation 对象将包含状态。如需了解详情，请参阅异步 API 方法。

如果您不想升级日志存储桶以使用日志分析，请省略 --enable-analytics 和 --async 标志。您可以将变量 LOCATION 设置为任何受支持的区域。

例如，如果要在 asia-east2 区域中创建具有 BUCKET_ID my-bucket 的存储桶，您的命令将如下所示：

gcloud logging buckets create my-bucket --location asia-east2 --description "My first bucket"

例如，如需在 us 位置创建一个具有 BUCKET_ID my-upgraded-bucket 的存储桶，然后将日志存储桶升级为使用日志分析，您的命令应如下所示：

gcloud logging buckets create my-upgraded-bucket --location us \
      --description "My first upgraded bucket" \
      --enable-analytics --retention-days=45

注意：创建日志存储桶后，您便无法更改存储桶所在的区域。如果您需要其他地区的存储桶，则必须在该地区中新建一个存储桶，并将相应的接收器重定向到新存储桶，然后删除旧存储桶。

API

注意 ：除非使用 Google Cloud 控制台，否则您无法在创建操作过程中创建关联的 BigQuery 数据集。但是，如果您创建并升级了日志存储桶，则可以使用 projects.locations.buckets.links.create 方法创建关联的数据集。

如需创建存储桶，请使用 projects.locations.buckets.create 或 projects.locations.buckets.createAsync 方法。请按以下步骤准备方法的参数：

1. 将 parent 参数设置为要在其中创建存储桶的资源： projects/PROJECT_ID/locations/LOCATION

   变量 LOCATION 是指您希望用来存储日志的区域。并非所有区域都支持 Log Analytics。如需了解详情，请参阅支持的区域。

   例如，如果要在 asia-east2 区域中为项目 my-project 创建存储桶，您的 parent 参数将如下所示：projects/my-project/locations/asia-east2

2. 设置 bucketId 参数；例如 my-bucket。

3. 执行下列其中一项操作：

   • 如需创建日志存储桶，然后升级日志存储桶以使用日志分析，请执行以下操作：

     1. 将 LogBucket.analyticsEnabled 布尔值设置为 true。

        警告： 升级日志存储桶以使用日志分析是不可逆转的操作。

     2. 调用异步方法 projects.locations.buckets.createAsync 以创建存储桶。

        对异步方法的响应是 Operation 对象。此对象包含有关方法进度的信息。该方法完成后，Operation 对象将包含状态。如需了解详情，请参阅异步 API 方法。

        createAsync 方法需要几分钟才能完成。当 analyticsEnabled 布尔值设置为 true 且升级后的存储分区不支持该区域时，此方法不会生成错误消息或失败。例如，如果您将位置设置为 asia-east2，则系统会创建日志存储桶，但不会将该存储桶升级为使用日志分析。

   • 否则，请调用同步方法 projects.locations.buckets.create 来创建存储桶。

创建存储桶后，可以创建接收器以将日志条目路由到您的存储桶，并配置日志视图以控制谁可以访问新存储桶中的日志，以及这些日志可以访问哪些日志。您还可以更新存储桶以配置自定义保留和受限字段。

跟踪日志提取

Google Cloud 控制台中的日志存储页面会跟踪日志存储分区注入的日志数据量。

如需跟踪 Google Cloud 项目的日志数据注入，请转到控制台中的日志存储页面：

前往“日志存储”

日志存储页面会显示 Google Cloud 项目的统计信息摘要：

系统会报告以下统计信息：

• 当月注入量：自当前日历月的第一天以来，您的 Google Cloud 项目注入的日志数据量。

• 上月注入量：您的 Google Cloud 项目在上个日历月注入的日志数据量。

• EOM 的预计注入量：根据当前用量，Google Cloud 项目将在当前日历月结束时注入的日志量估算值。

• 当月计费存储：已保留超过 30 天的日志数据量。

日志提取量统计信息不包含 _Required 存储桶。无法排除或停用该存储桶中的日志。

Google Cloud 控制台中的日志路由器页面为您提供了多种工具，您可以使用这些工具来尽可能地减少超出每月配额的日志提取或存储产生的费用。您可以执行以下操作：

• 在存储桶级别停用日志注入。
• 不要将某些日志条目注入 Logging。

如需了解详情，请参阅管理接收器。

管理存储桶

本部分介绍如何使用 Google Cloud CLI 或 Google Cloud 控制台管理日志存储分区。

更新存储桶

如需更新存储桶的属性（例如说明或保留期限），请执行以下操作：

Google Cloud 控制台

如需更新存储桶的属性，请执行以下操作：

1. 从“日志记录”菜单中选择日志存储。

   前往“日志存储”

2. 针对要更新的存储桶，点击 更多。

3. 选择修改存储桶。

4. 根据需要修改存储桶。

5. 点击更新存储桶。

gcloud

如需更新存储桶的属性，请运行 gcloud logging buckets update 命令：

gcloud logging buckets update BUCKET_ID --location=LOCATION UPDATED_ATTRIBUTES

例如：

gcloud logging buckets update my-bucket --location=global --description "Updated description"

API

如需更新存储桶的属性，请在 Logging API 中使用 projects.locations.buckets.patch。

升级存储桶以使用日志分析

警告： 升级日志存储桶以使用日志分析是不可逆转的。只有升级完成后写入的日志条目可用于分析。

如需升级现有存储桶以使用日志分析，需要遵循以下限制：

• 日志存储桶是在 Google Cloud 项目级创建的。
• 尚未配置字段级访问权限控制。
• 日志存储桶已解锁，除非它是 _Required 存储桶。
• 存储桶没有待处理的更新。

• 并非所有区域都支持 Log Analytics。如需了解详情，请参阅支持的区域。

Google Cloud 控制台

如需升级现有存储桶以使用日志分析，请执行以下操作：

1. 从“日志记录”菜单中选择日志存储。

   前往“日志存储”

2. 找到要升级的存储桶。

3. 当有可用的日志分析列显示升级时，您可以升级日志存储桶以使用日志分析。点击升级。

   系统会显示一个对话框。点击确认。

gcloud

如需升级日志存储桶以使用日志分析，请运行 gcloud logging buckets update 命令。您必须设置 --enable-analytics 标志，我们建议您同时添加 --async 标志：

gcloud logging buckets update BUCKET_ID --location=LOCATION --enable-analytics --async

--async 标志用于强制运行异步命令。异步方法的返回是一个 Operation 对象，它包含有关方法进度的信息。该方法完成后，Operation 对象将包含状态。如需了解详情，请参阅异步 API 方法。

注意 ：升级日志存储桶以使用日志分析时，请勿更新日志存储桶的任何其他属性。例如，调用更改保留期限并升级日志存储桶的 update 命令会失败。

API

如需升级日志存储桶以使用日志分析，请使用 Cloud Logging API 的 projects.locations.buckets.updateAsync 方法。

请按以下步骤准备方法的参数：

1. 将 LogBucket.analyticsEnabled 布尔值设置为 true。
2. 对于该命令的查询参数，请使用 updateMask=analyticsEnabled。

对异步方法的响应是 Operation 对象。此对象包含有关方法进度的信息。该方法完成后，Operation 对象将包含状态。如需了解详情，请参阅异步 API 方法。

updateAsync 可能需要几分钟才能完成。

创建关联的 BigQuery 数据集

如果您想要使用 BigQuery 的功能来分析日志数据，请升级日志存储桶以使用日志分析，然后创建已关联的数据集。借助此配置，您可以使用 BigQuery 读取存储在日志存储桶中的日志。

注意 ：一个日志存储桶最多只能关联到一个 BigQuery 数据集。

Google Cloud 控制台

如需为现有日志存储桶创建与 BigQuery 数据集的关联，请执行以下操作：

1. 查看本文档中的准备工作部分。

2. 从“日志记录”菜单中选择日志存储。

   前往“日志存储”

3. 找到日志存储桶，并验证 Log Analytics available 列是否显示打开。

   如果此列显示升级，则表示日志存储桶尚未升级以使用日志分析。配置日志分析：

   1. 点击升级。
   2. 在对话框中点击确认。

   升级完成后，继续执行下一步。

4. 在日志存储桶中，点击更多，然后点击修改存储桶。

   修改日志存储桶对话框随即打开。

5. 选择创建链接到此存储桶的新 BigQuery 数据集，然后输入新数据集的名称。您的 Google Cloud 项目的数据集名称必须是唯一的。

6. 点击完成，然后点击更新存储桶。

   Logging 在日志存储页面上显示关联的数据集名称后，BigQuery 可能需要几分钟才能识别该数据集。

gcloud

如需为升级为使用日志分析的日志存储桶创建关联的数据集，请运行 gcloud logging links create 命令：

gcloud logging links create LINK_ID --bucket=BUCKET_ID --location=LOCATION

在您的 Google Cloud 项目中，LINK_ID 字段必须是唯一的。

links create 命令是异步的。异步方法的返回是一个 Operation 对象，它包含有关方法进度的信息。该方法完成后，Operation 对象将包含状态。如需了解详情，请参阅异步 API 方法。

links create 命令需要几分钟才能完成。

例如，以下命令会为名为 my-bucket 的存储桶创建一个关联的数据集：

gcloud logging links create mylink --bucket=my-bucket --location=global

如果您尝试为未升级为使用日志分析的日志存储桶创建关联的数据集，则系统会报告以下错误：

A link can only be created for an analytics-enabled bucket.

API

如需为使用日志分析的现有日志存储桶创建 BigQuery 数据集关联，请调用 Cloud Logging API 的异步 projects.locations.buckets.links.create 方法。

请按以下步骤准备方法的参数：

1. 创建一个 Link 对象。
2. 对于该命令的查询参数，请使用 linkId=LINK_ID。

对异步方法的响应是 Operation 对象。此对象包含有关方法进度的信息。该方法完成后，Operation 对象将包含状态。如需了解详情，请参阅异步 API 方法。

links.create 方法需要几分钟才能完成。

如果您尝试为未升级为使用日志分析的日志存储桶创建关联的数据集，则系统会报告以下错误：

A link can only be created for an analytics-enabled bucket.

锁定存储桶

警告：锁定日志存储桶是不可逆转的。

如果根据更新来锁定存储桶，则也会锁定存储桶的保留政策。保留政策锁定后，您将无法删除存储桶，除非存储桶中的所有日志都已达到存储桶的保留期限。

如需阻止任何人更新或删除日志存储桶，请锁定该存储桶。如需锁定存储桶，请执行以下操作：

Google Cloud 控制台

Google Cloud 控制台不支持锁定日志存储桶。

gcloud

如需锁定存储桶，请运行带有 --locked 标志的 gcloud logging buckets update 命令：

gcloud logging buckets update BUCKET_ID --location=LOCATION --locked

例如：

gcloud logging buckets update my-bucket --location=global --locked

API

如需锁定存储桶的特性，请使用 Logging API 中的 projects.locations.buckets.patch。将 locked 参数设置为 true。

列出存储桶

如需列出与 Google Cloud 项目关联的日志存储分区，以及查看保留设置等详细信息，请执行以下操作：

Google Cloud 控制台

转到日志存储页面：

前往“日志存储”

名为日志存储分区的表列出了与当前 Google Cloud 项目关联的存储分区。

该表列出了每个日志存储桶的以下特性：

• 名称：日志存储桶的名称。
• 说明：存储桶的说明。
• 保留期限：Cloud Logging 将对存储桶数据进行存储的天数。
• 区域：用于对存储桶数据的地理位置进行存储。
• 状态：存储桶处于锁定状态还是解锁状态。

如果某个存储桶正在等待 Cloud Logging 删除，其表条目将使用警告 注明。

gcloud

运行 gcloud logging buckets list 命令：

gcloud logging buckets list

您会看到日志存储桶的以下特性：

• LOCATION：用于存储存储桶数据的区域。
• BUCKET_ID：日志存储桶的名称。
• RETENTION_DAYS：Cloud Logging 将存储桶数据存储的天数。
• LIFECYCLE_STATE：指示一个存储桶是否在等待 Cloud Logging 删除。
• LOCKED：存储桶处于锁定状态还是解锁状态。
• CREATE_TIME：指示存储桶创建时间的时间戳。
• UPDATE_TIME：指示上次修改存储桶的时间戳。

您还可以仅查看一个存储桶的特性。例如，如需查看 global 区域中 _Default 日志存储桶的详细信息，请运行 gcloud logging buckets describe 命令：

gcloud logging buckets describe _Default --location=global

API

如需列出与 Google Cloud 项目相关联的日志存储分区，请使用 Logging API 中的 projects.locations.buckets.list。

查看存储桶的详细信息

如需查看单个日志存储桶的详细信息，请执行以下操作：

Google Cloud 控制台

转到日志存储页面：

前往“日志存储”

在日志存储桶上，点击更多 > 查看存储桶详情。

对话框会列出日志存储桶的以下特性：

• 名称：日志存储桶的名称。
• 说明：日志存储桶的说明。
• 保留期限：Cloud Logging 将对存储桶数据进行存储的天数。
• 区域：用于对存储桶数据的地理位置进行存储。
• 日志分析：指示您的存储桶是否升级到使用日志分析。
• BigQuery 分析：指示 BigQuery 数据集是否已关联到您的存储桶。
• BigQuery 数据集：提供指向 BigQuery 数据集的链接，这会在 BigQuery SQL 工作区页面中打开。系统还会显示 BigQuery 关联的启用日期。

gcloud

运行 gcloud logging buckets describe 命令。

例如，以下命令会报告 _Default 存储桶的详细信息：

gcloud logging buckets describe _Default --location=global

您会看到日志存储桶的以下特性：

• createTime：指示存储桶创建时间的时间戳。
• description：日志存储桶的说明。
• lifecycleState：指示一个存储桶是否在等待 Cloud Logging 删除。
• name：日志存储桶的名称。
• retentionDays：Cloud Logging 将存储桶数据存储的天数。
• updateTime：指示上次修改存储桶的时间戳。

API

如需查看单个日志存储桶的详细信息，请使用 Logging API 中的 projects.locations.buckets.get。

删除存储桶

如需删除日志存储桶，请执行以下操作：

Google Cloud 控制台

如需删除日志存储桶，请执行以下操作：

1. 从“日志记录”菜单中选择日志存储。

   前往“日志存储”

2. 找到您要删除的存储桶，然后点击更多。

3. 如果 BigQuery 中的关联数据集列显示关联，请删除关联的 BigQuery 数据集：

   1. 点击修改存储桶。

   2. 清除创建链接到此存储桶的新 BigQuery 数据集，点击完成，然后点击更新存储桶。

      返回日志存储页面后，点击要删除的存储桶的 更多，然后继续执行后续步骤。

4. 选择删除存储桶。

5. 在确认面板上，点击删除。

6. 在日志存储页面上，会有一个指示符显示该存储桶正在等待删除。该存储桶（包括其中的所有日志）将在 7 天后删除。

gcloud

如需删除日志存储桶，请运行 gcloud logging buckets delete 命令：

gcloud logging buckets delete BUCKET_ID --location=LOCATION

当日志存储桶具有关联的 BigQuery 数据集时，您无法删除日志存储桶：

• 如需列出与日志存储桶关联的链接，请运行 gcloud logging links list 命令。
• 如需删除关联的数据集，请运行 gcloud logging links delete 命令。

API

如需删除存储桶，请使用 Logging API 中的 projects.locations.buckets.delete。

如果日志存储桶具有关联的 BigQuery 数据集，则删除该存储桶是错误的。您必须先删除关联的数据集，然后才能删除日志存储桶：

• 如需列出与日志存储桶关联的链接，请运行 projects.locations.buckets.links.list 方法。
• 如需删除关联的数据集，请运行 projects.locations.buckets.links.delete 方法。

已删除的存储桶会以待处理状态保留 7 天，在此期间 Logging 会继续将日志路由到该存储桶。您可以通过以下方法停止将日志路由到已删除的存储桶：删除将该存储桶作为目标位置的日志接收器，或者修改这些接收器的过滤条件。

注意 ：待删除的存储分区计入每个 Google Cloud 项目的存储分区配额，直到其被完全删除。

恢复已删除的存储桶

您可以恢复或取消删除处于待删除状态的日志存储桶。如需恢复日志存储桶，请执行以下操作：

Google Cloud 控制台

如需恢复待删除的日志存储桶，请执行以下操作：

1. 从“日志记录”菜单中选择日志存储。

   前往“日志存储”

2. 找到要恢复的存储桶，然后点击更多 ()。

3. 选择恢复已删除的存储桶。

4. 在确认面板上，点击恢复。

5. 在日志存储页面上，待删除指示符会从您的存储桶移除。

gcloud

如需恢复待删除的日志存储桶，请运行 gcloud logging buckets undelete 命令：

gcloud logging buckets undelete BUCKET_ID --location=LOCATION

API

如需恢复待删除的存储桶，请使用 Logging API 中的 projects.locations.buckets.undelete。

每月日志注入量提醒

如需创建提醒政策，请在 Google Cloud 控制台的日志存储页面上点击 创建使用情况提醒。此按钮会在 Monitoring 中打开创建提醒政策页面，并使用 logging.googleapis.com/billing/bytes_ingested 填充指标类型字段。

如需创建一项提醒政策，以便在您的每月日志字节数超出用户定义的 Cloud Logging 限制时触发，请使用以下设置。

创建提醒政策的步骤。

如需创建提醒政策，请执行以下操作：

1. 在 Google Cloud 控制台中，转到 Monitoring 或使用下面的按钮：
   转到 Monitoring
2. 在 Monitoring 导航窗格中，选择 提醒，然后选择创建政策。
3. 如果您尚未创建通知渠道并希望收到通知，请点击修改通知渠道并添加通知渠道。添加渠道后，返回到提醒页面。
4. 在提醒页面中，点击创建政策。
5. 要选择资源、指标和过滤条件，请展开选择指标菜单，然后使用新建条件表中的值：
   1. 可选：如需将菜单限制为相关条目，请在过滤栏中输入资源或指标名称。
   2. 选择一种资源类型。例如，选择虚拟机实例。
   3. 选择指标类别。例如，选择实例。
   4. 选择一个指标。例如，选择 CPU 利用率。
   5. 选择应用。
6. 点击下一步，然后配置提醒政策触发器。 如需填写这些字段，请使用配置提醒触发器表中的值。
7. 点击下一步。

8. 可选：如需将通知添加到您的提醒政策中，请点击通知渠道。在对话框中，从菜单中选择一个或多个通知渠道，然后点击确定。

   如需在开启和关闭突发事件时接收通知，请选中突发事件关闭时通。默认情况下，仅在开启突发事件时发送通知。

9. 可选：更新突发事件自动关闭持续时间。此字段用于确定在缺少指标数据的情况下 Monitoring 何时关闭突发事件。
10. 可选：点击文档，然后添加您希望包含在通知消息中的任何信息。
11. 点击提醒名称，然后输入提醒政策的名称。
12. 点击创建政策。

新建条件 字段	值
资源和指标	在资源菜单中，选择全局。 在指标类别菜单中，选择基于日志的指标。 在指标菜单中，选择每月日志注入的字节数。
过滤	无。
跨时序 时序聚合	sum
滚动窗口	60 m
滚动窗口函数	max

配置提醒触发器 字段	值
条件类型	Threshold
提醒触发器	Any time series violates
阈值位置	Above threshold
阈值	可接受的值由您决定。
重新测试窗口	可接受的最小值是 30 分钟。

如需详细了解提醒政策，请参阅提醒概览。

写入存储桶

您无法直接将日志写入日志存储桶，而是将日志写入 Google Cloud 资源：Google Cloud 项目、文件夹或组织。然后，父级资源中的接收器会将日志路由到目标位置，包括日志存储桶。当日志与接收器的过滤条件匹配并且接收器有权将日志路由到日志存储桶时，接收器会将日志路由到日志存储桶目标位置。

从存储桶读取

每个日志存储桶都包含一组日志视图。如需从日志存储桶读取日志，您需要能够访问日志存储桶中的日志视图。如需详细了解日志视图，请参阅配置存储桶级访问权限。

如需从日志存储桶读取日志，请执行以下操作：

Google Cloud 控制台

您可以通过优化范围选项优化日志浏览器中显示的日志的范围。您只能搜索当前 Google Cloud 项目中的日志，也可以在一个或多个存储视图中搜索日志。 如需优化日志浏览器的范围，请执行以下操作：

1. 从“日志记录”菜单中选择日志浏览器。

   转到日志浏览器

2. 选择优化范围。

3. 在优化范围对话框上，选择范围选项。

4. 选择按存储确定范围，然后选择一个或多个存储桶。

   该对话框会列出满足以下条件的存储视图：

   • 您有权访问存储视图。
   • 日志存储分区属于所选的 Google Cloud 项目，或者所选 Google Cloud 项目之前已将日志路由到存储分区。

gcloud

如需读取日志存储桶中的日志，请使用 gcloud logging read 命令并添加 LOG_FILTER 以选择数据：

gcloud logging read LOG_FILTER --bucket=BUCKET_ID --location=LOCATION --view=VIEW_ID

API

要从日志存储桶读取日志，请使用 entries.list 方法。设置 resourceNames 以指定适当的存储桶和日志视图，然后设置 filter 以选择数据。

如需详细了解过滤语法，请参阅 Logging 查询语言。

配置自定义保留

注意 ：自 2023 年 4 月 1 日起，存储时间超过 30 天的日志数据将产生存储费用。 如需了解价格详情，请参阅 Cloud Logging 价格摘要。如需查看日志存储分区的计费存储空间，请前往 Google Cloud 控制台的日志存储页面。

创建日志存储桶时，您可以选择自定义 Cloud Logging 存储存储桶日志的时长。您可以为任何用户定义的日志存储桶以及 _Default 日志存储桶配置保留期限。

如果您缩短了存储桶的保留期限，则系统将在 7 天的宽限期内删除过期的日志。您无法查询或查看这些过期的日志，但在这 7 天内，您可以通过延长存储桶的保留期限来恢复完整访问权限。在宽限期内存储的日志会计入您的存储费用。

如需更新日志存储桶的保留期限，请执行以下操作：

Google Cloud 控制台

如需更新日志存储桶的保留期限，请执行以下操作：

1. 从“日志记录”菜单中选择日志存储。

   前往“日志存储”

2. 找到要更新的存储桶，然后点击更多 ()。

3. 选择修改存储桶。

4. 在保留字段中，输入您希望 Cloud Logging 保留日志的天数（介于 1 天到 3650 天之间）。

5. 点击更新存储桶。新的保留时长会显示在日志存储桶列表中。

gcloud

如需更新日志存储桶的保留期限，请在为 RETENTION_DAYS 设置值后运行 gcloud logging buckets update 命令：

gcloud logging buckets update BUCKET_ID  --location=LOCATION --retention-days=RETENTION_DAYS

例如，要将日志存储在 _Default 存储桶中的 global 位置一年，则命令应如下所示：

gcloud logging buckets update _Default --location=global --retention-days=365

如果您延长存储桶的保留期限，则保留规则会在以后应用，并且不会追溯应用。日志在适用的保留期限结束后无法恢复。

异步 API 方法

诸如 projects.locations.buckets.createAsync 之类的异步方法的响应是 Operation 对象。

调用异步 API 方法的应用应轮询 operation.get 端点，直到 Operation.done 字段的值为 true：

• 当 done 为 false 时，表示操作正在进行中。

  如需刷新状态信息，请向 operation.get 端点发送 GET 请求。

• 当 done 为 true 时，表示操作已完成且已设置 error 或 response 字段：

  • error：设置此标志时，表示异步操作失败。此字段的值是一个 Status 对象，其中包含 gRPC 错误代码和错误消息。
  • response：如果设置此标志，则表示异步操作成功完成，并且值将反映结果。

如需使用 Google Cloud CLI 轮询异步命令，请运行以下命令：

gcloud logging operations describe OPERATION_ID --location=LOCATION --project=PROJECT_ID

如需了解详情，请参阅 gcloud logging operations describe。

排查常见问题

如果您在使用日志存储桶时遇到问题，请参阅以下问题排查步骤以及常见问题解答。

为什么我无法删除此存储桶？

如果要尝试删除存储桶，请执行以下操作：

• 确保您拥有删除存储桶存储桶的适当权限。如需查看所需的权限，请参阅使用 IAM 进行访问权限控制。

• 通过列出存储桶的特性来确定存储桶是否已锁定。如果存储桶已被锁定，请检查存储桶的保留期限。在存储桶中的所有日志都达到存储桶的保留期限之前，您无法删除锁定的存储桶。

• 验证日志存储桶没有关联的 BigQuery 数据集。您无法删除具有关联数据集的日志存储桶。

  为了响应具有关联数据集的日志存储桶的 delete 命令，系统会显示以下错误：

  FAILED_PRECONDITION: This bucket is used for advanced analytics and has an active link. The link must be deleted first before deleting the bucket
  

  如需列出与日志存储桶关联的链接，请运行 gcloud logging links list 命令或运行 projects.locations.buckets.links.list API 方法。

哪些服务帐号会将日志路由到我的存储桶？

如需确定是否有任何服务帐号具有将日志路由到存储桶的 IAM 权限，请执行以下操作：

1. 转到包含该存储桶的 Google Cloud 项目的“Identity and Access Management”页面：

   转到 IAM

2. 在权限标签页中，按角色查看。您会看到一个表，其中包含与您的 Google Cloud 项目关联的所有 IAM 角色和主帐号。

3. 在该表的过滤条件文本框中，输入 Logs Bucket Writer。

   您会看到任何具有 Logs Bucket Writer 角色的主帐号。如果主帐号是服务帐号，则其 ID 包含字符串 gserviceaccount.com。

4. 可选：如果您想要移除某个服务帐号，使其能够将日志路由到您的 Google Cloud 项目，请选中该服务帐号对应的复选框，然后点击移除。

为什么我排除了 Google Cloud 项目的日志，即使这些日志已从 _Default 接收器中排除？

您可能会在集中式 Google Cloud 项目的日志存储桶中查看日志，该项目汇总了整个组织的日志。

如果您使用日志浏览器访问这些日志，并查看从 _Default 接收器中排除的日志，那么您的视图可能仅限 Google Cloud 项目级视图。

如需解决此问题，请在优化范围面板中选择按存储范围，然后在 Google Cloud 项目中选择 _Default 存储桶。您应该不会再看到已排除的日志。

为什么我无法为存储桶创建基于日志的指标？

基于日志的指标仅适用于单个 Google Cloud 项目。您无法为日志存储分区或其他 Google Cloud 资源（例如文件夹或组织）创建服务帐号。

后续步骤

如需了解日志存储桶 API 方法，请参阅 LogBucket 参考文档。

如需了解如何使用日志存储桶解决常见用例，请参阅以下主题：

• 汇总并存储组织的日志。

• GKE 上的多租户日志记录。

• 对日志进行区域化。