Google Stackdriver Logging Uzantısı

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Sürüm 1.3.7

Stackdriver Logging günlüklerine giriş yazın.

Bu içerik, bu uzantının yapılandırılması ve kullanılması için referans sağlamaktadır.

Ön koşullar

Bu uzantıyı bir API proxy'sinden kullanmadan önce şunları yapmanız gerekir:

1. IAM'de Günlük Kaydı > Günlük Yazıcı ve Günlük Kaydı > Günlük Görüntüleyici rolünü, Campaign Logging sistemindeki uzantınızı temsil edecek proje üyesine verebilirsiniz. Rollerin nasıl atanacağıyla ilgili talimatları Belirli kaynaklar için hizmet hesabına rol atama başlıklı makalede bulabilirsiniz. Günlük kaydı rolleri hakkında daha fazla bilgi için Erişim Denetimi Kılavuzu'na bakın.

2. GCP Console'u kullanarak hizmet hesabı için bir anahtar oluşturun.

3. Yapılandırma referansını kullanarak uzantıyı eklerken ve yapılandırırken sonuçta ortaya çıkan anahtar JSON dosyasının içeriğini kullanın.

Bu uzantı, PostClientFlow'da bulunan bir ExtensionReference politikası tarafından çağrılmayı destekler. Bu uzantıyı PostClientFlow, features.allowExtensionsInPostClientFlow işaretinin kuruluşunuzda true olarak ayarlanmış olmalıdır.

• Herkese Açık Bulut alanında Apigee Edge müşterisiyseniz Apigee Edge Destek Ekibi ile iletişime geçerek features.allowExtensionsInPostClientFlow işareti kuruluşunuzda true olarak ayarlandı.

• Private Cloud müşterisi iseniz Apigee Edge'i Kuruluş özelliklerini güncelleme API'si features.allowExtensionsInPostClientFlow işaretini true olarak ayarlayın.

Cloud Logging hakkında

Stackdriver Logging, Google Cloud Platform'daki (GCP) ürün paketinin bir parçasıdır. Günlükler için depolama, Günlük Görüntüleyici adı verilen 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 okuyup yazabilir, günlüklerinizi arayıp filtreleyebilir, günlüklerinizi dışa aktarabilir ve günlük tabanlı metrikler oluşturabilirsiniz.

Bu uzantı şu anda günlüğe girişler yazıyor. Daha fazla bilgi için Stackdriver Logging belgelerine bakın.

Örnekler

Aşağıdaki örnekler, Uzantı Çağrı Politikası'nı kullanarak Stackdriver Logging uzantı işlemleri için desteğin nasıl yapılandırılacağını gösterir.

Genel günlük

Aşağıdaki politika, "Bu bir testtir" mesajını yazar bir günlüğe kaydeder. Gerçek kullanımda muhtemelen mesaj, değerini API proxy'sinde başka bir yerde ayarladığınız bir akış değişkeninde yer alacaktır.

<?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çerik, bu uzantının yapılandırılması ve kullanılması için referans sağlamaktadır. Apigee konsolunu kullanarak uzantı yapılandırma adımları için Uzantı ekleme ve yapılandırma'ya bakın.

İş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 özelliğinin içeriği hakkında bilgi için Cloud Logging belgelerindeki 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

Mesaj günlüğe yazıldıysa yok değerini alır. Aksi takdirde istek bir hata döndürür. Ayrıca, Uzantılarda hata ayıklama bölümüne de göz atın.

Yapılandırma Referansı

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

Sık kullanılan uzantı özellikleri

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

Bu uzantı paketinin özellikleri

Bu uzantıya özel aşağıdaki yapılandırma özelliklerinin değerlerini belirtin.