Google Stackdriver Logging Uzantısı

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info

Sürüm 1.2.0

Stackdriver Logging günlüklerine giriş yazma

Bu içerikte, bu uzantıyı yapılandırma ve kullanmayla ilgili referanslar sağlanmaktadır.

Ön koşullar

Bu uzantıyı bir API proxy'sinden kullanmadan önce:

1. IAM'da, Logging > Günlük Yazıcı iznini, Stackdriver Logging sisteminde uzantınızı temsil edecek proje üyesine atayın. Rol vermeyle ilgili talimatlar için Belirli kaynaklar için bir hizmet hesabına rol verme başlıklı makaleyi inceleyin. Günlüğe kaydetme rolleri hakkında daha fazla bilgi için Erişim Denetimi Kılavuzu'na bakın.

2. Hizmet hesabı için anahtar oluşturmak üzere GCP Console'u kullanın.

3. Yapılandırma referansını kullanarak uzantıyı ekleyip yapılandırırken elde edilen anahtar JSON dosyasının içeriğini kullanın.

Stackdriver Logging hakkında

Stackdriver Logging, Google Cloud Platform'daki (GCP) Stackdriver ürün paketinin bir parçasıdır. Günlükler için depolama alanı, Günlük Görüntüleyici adlı bir kullanıcı arayüzü ve günlükleri programatik olarak yönetmek için bir API içerir. Stackdriver Logging ile günlük girişlerini okuyabilir ve yazabilir, günlüklerinizi arayabilir ve filtreleyebilir, günlüklerinizi dışa aktarabilir ve günlük tabanlı metrikler oluşturabilirsiniz.

Bu uzantı şu anda günlüklere giriş yazıyor.

Daha fazla bilgi için Stackdriver Logging belgelerine bakın.

Örnekler

Aşağıdaki örneklerde, ExtensionCallout politikası kullanılarak Stackdriver Logging uzantı işlemleri için desteğin nasıl yapılandırılacağı gösterilmektedir.

Global günlük

Aşağıdaki politika, "Bu bir test" mesajını Stackdriver Global kaynağındaki example-log adlı bir günlüke yazar. Gerçek kullanımda, mesajı muhtemelen API proxy'sinde başka bir yerde değerini ayarladığınız bir akış değişkeninde barındırırsınız.

<?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>

Bu içerikte, bu uzantıyı yapılandırma ve kullanmayla ilgili referanslar sağlanmaktadır. Apigee konsolunu kullanarak bir uzantıyı yapılandırma adımları için Uzantı ekleme ve yapılandırma başlıklı makaleyi inceleyin.

İşlemler

log

Günlüğe bir mesaj yazar.

Bu işlem, bir Stackdriver günlük girişi yazar. Günlük girişleri, meta verilerden ve giriş verilerinden oluşur. Günlük girişleri hakkında daha fazla bilgi için Giriş referansı bölümüne bakın. metadata mülkünün içeriği hakkında bilgi edinmek için Stackdriver Logging dokümanlarında LogEntry nesnesine bakın.

<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>

İstek parametreleri

Yanıt

İleti günlük kaydına yazılmışsa yok. Aksi takdirde istek hata döndürür. Ayrıca Uzantılarda hata ayıklama başlıklı makaleyi inceleyin.

Yapılandırma Referansı

Bu uzantıyı API proxy'lerinde kullanılmak üzere yapılandırırken ve dağıtırken aşağıdakileri kullanın.

Ortak uzantı özellikleri

Aşağıdaki özellikler her uzantı için mevcuttur.

Bu uzantı paketine ait özellikler

Bu uzantıya özgü aşağıdaki yapılandırma özellikleri için değerler belirtin.