Google Stackdriver Logging Uzantısı

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

1.3.7 sürümü

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, Stackdriver Logging sistemine uzantınızı temsil edecek proje üyesine Günlük > Günlük Yazıcı ve Günlük > Günlük Görüntüleyici rolünü 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.

Bu uzantı, PostClientFlow içinde bulunan bir ExtensionCallout politikası tarafından çağrılmayı destekler. Bu uzantıyı PostClientFlow'dan çağırmak için ExtensionCallout politikasını kullanmak istiyorsanız kuruluşunuzda features.allowExtensionsInPostClientFlow işaretinin true olarak ayarlandığından emin olun.

• Public Cloud için Apigee Edge müşterisiyseniz kuruluşunuzda features.allowExtensionsInPostClientFlow işaretinin true olarak ayarlandığından emin olmak için Apigee Edge Destek Ekibi ile iletişime geçmeniz gerekir.

• Private Cloud için Apigee Edge müşterisiyseniz features.allowExtensionsInPostClientFlow işaretini true olarak ayarlamak için Kuruluş özelliklerini güncelle API'sini 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.