Google Stackdriver Logging 扩展程序

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 信息

版本 1.3.7

将条目写入 Stackdriver Logging 日志。

本文提供了配置和使用此扩展程序的参考信息。

前提条件

通过 API 代理使用此扩展程序之前，您必须：

1. 在 IAM 中，分配 Logging >Logs Writer 和 Logging >Logs Viewer 角色分配给项目成员，该角色代表您的 Stackdriver Logging 系统扩展程序。如需了解如何授予角色，请参阅为服务账号授予特定资源的角色。 如需详细了解日志记录角色，请参阅访问权限控制指南。

2. 使用 GCP Console 为服务账号生成密钥。

3. 在通过配置参考添加和配置扩展程序时，使用所生成的密钥 JSON 文件的内容。

此扩展程序支持由位于 PostClientFlow 中的 ExtensionCallout 政策调用。 如果您想使用附加信息宣传信息政策通过 PostClientFlow 时，请确保 features.allowExtensionsInPostClientFlow 标志 设为“true”。

• 如果您是适用于公有云的 Apigee Edge 的客户，则必须联系 Apigee Edge 支持团队，以确保 贵组织中的 features.allowExtensionsInPostClientFlow 标志已设置为 true。

• 如果您是适用于私有云的 Apigee Edge 客户，请使用 更新组织属性 API 将 features.allowExtensionsInPostClientFlow 标志设置为 true。

Stackdriver Logging 简介

Stackdriver Logging 是 Google Cloud Platform (GCP) 中 Stackdriver 产品套件的一部分。它包含日志存储、名为日志查看器的界面以及以编程方式管理日志的 API。借助 Stackdriver Logging，您可以读取和写入日志条目、搜索和过滤日志、导出日志以及创建基于日志的指标。

此扩展程序目前会将条目写入日志。如需了解详情，请参阅 Stackdriver Logging 文档。

示例

以下示例说明了如何使用 ExtensionCallout 政策配置对 Stackdriver Logging 扩展程序操作的支持。

全局日志

以下政策会写入消息“This is a test”到 Stackdriver 全局资源中名为 example-log 的日志。在实际使用中，您可能会让消息包含在流变量中，您在 API 代理的其他位置设置了该变量的值。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Logging-Extension">
    <DisplayName>Logging Connector</DisplayName>
    <Connector>stackdriver-extension-sample</Connector>
    <Action>log</Action>
    <Input><![CDATA[{
        "logName": "example-log",
        "metadata": {
            "resource": {
                "type": "global",
                "labels": {
                    "project_id": "my-test"
                }
            }
        },
        "message": "This is a test"
    }]]></Input>
</ConnectorCallout>

本文提供了配置和使用此扩展程序的参考信息。如需了解使用 Apigee 控制台配置扩展程序的步骤，请参阅添加和配置扩展程序。

操作

log

向日志写入一条消息。

此操作会写入一个 Stackdriver 日志条目。日志条目由元数据和条目数据组成。如需详细了解日志条目，请参阅条目参考文档。如需了解 metadata 属性的内容，请参阅 Stackdriver Logging 文档中的 LogEntry 对象。

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "stackdriver-log-name-to-use",
  "metadata" : JSON-structured-metadata,
  "message" : "data-to-log-as-entry"
}]]></Input>

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "stackdriver-log-name-to-use",
  "metadata" : { "resource" : { "type" : "global" } },
  "message" : "data-to-log-as-entry"
}]]></Input>

请求参数

响应

无（如果消息已写入日志）。否则，请求将返回错误。另请参阅调试扩展程序。

配置参考

在配置和部署此扩展程序以供在 API 代理中使用时，请使用以下代码。

常见的扩展属性

每个扩展程序都有以下属性。

此扩展程序软件包的属性

为此扩展程序的以下配置属性指定值。