使用 Azure Monitor Log Analytics 诊断设置监视 Azure Cosmos DB 数据

适用对象: NoSQL MongoDB Cassandra Gremlin

Azure 中的诊断设置用于收集资源日志。 资源发出 Azure 资源日志,并提供与该资源操作相关的各种频繁生成的数据。 这些日志是按请求捕获的,也称为“数据平面日志”。 部分数据平面操作的示例包括 delete、insert 和 readFeed。 这些日志的内容因资源类型而异。

若要了解有关诊断设置的详细信息,请参阅 Azure Monitor 中的诊断设置

注意

建议按照 REST API 选项卡中的说明,在特定于资源模式下创建诊断设置(适用于除表 API 之外的所有 API)。此选项通过改进的数据处理视图提供了额外的成本优化。

先决条件

  • 现有的 Azure Cosmos DB 帐户。
  • 现有的 Azure Monitor Log Analytics 工作区。

警告

如果你需要删除资源,重命名或移动资源,或者跨资源组或订阅迁移它,请首先删除其诊断设置。 否则,如果重新创建此资源,则已删除资源的诊断设置可能包含在新资源中,具体取决于每个资源的资源配置。 如果诊断设置包含在新资源中,则会恢复诊断设置中定义的资源日志收集,并将适用的指标和日志数据发送到先前配置的目标。

此外,为了保持环境整洁,最好删除将要删除且不打算再次使用的资源的诊断设置。

创建诊断设置

我们将在此演练为帐户创建诊断设置的过程。

注意

目前不支持将指标作为类别导出到日志。

  1. 登录到 Azure 门户

  2. 导航到现有的 Azure Cosmos DB 帐户。

  3. 在资源菜单的“监视”部分,选择“诊断设置”。 然后,选择“添加诊断设置”选项。

    诊断设置列表的屏幕截图,其中包含用于创建新设置或编辑现有设置的选项。

    重要

    如果帐户未启用“全文查询”功能,你可能会看到“启用全文查询 […] 以获取更详细的日志记录”提示。 如果不希望启用此功能,可以放心地忽略此警告。 有关详细信息,请参阅启用全文查询

  4. 在“诊断设置”窗格中,将设置命名为“example-setting”,然后选择“QueryRuntimeStatistics”类别。 启用“发送到 Log Analytics 工作区”复选框,选择你现有的工作区。 最后,选择“特定于资源”作为目标选项。

    用于配置诊断设置的各种选项的屏幕截图。

启用日志记录查询文本的全文查询功能

Azure Cosmos DB 提供高级日志记录以进行详细的故障排除。 启用全文查询功能后,你将能够查看 Azure Cosmos DB 帐户中所有请求的已取消模糊处理的查询。 你还将为 Azure Cosmos DB 提供权限,以访问并在日志中显示此数据。

警告

启用此功能可能会产生额外的日志记录成本,有关定价详细信息,请访问 Azure Monitor 定价。 建议在故障排除后禁用此功能。

  1. 在现有的 Azure Cosmos DB 帐户页上,选择资源菜单“设置”部分中的“功能”选项。 然后,选择“诊断全文查询”功能。

    Azure Cosmos DB 帐户的可用功能的屏幕截图。

  2. 在对话框中,选择“Enable”。 此设置将在几分钟内应用。 所有新引入的日志现在都具有每个请求的全文或 PIICommand 文本。

    为 Azure Cosmos DB 帐户启用诊断全文查询功能的屏幕截图。