Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
Wersja 1.2.1
Utwórz wpisy w logach Stackdriver Logging.
Ta treść zawiera informacje na temat konfigurowania tego rozszerzenia i korzystania z niego.
Wymagania wstępne
Zanim użyjesz tego rozszerzenia z poziomu serwera proxy interfejsu API, musisz:
W sekcji Uprawnienia przypisz uprawnienia Logging > Zapisujący logi członkowi projektu, który będzie reprezentować Twoje rozszerzenie w systemie Stackdriver Logging. Instrukcje przypisywania ról znajdziesz w sekcji Przypisywanie ról do konta usługi dla określonych zasobów. Więcej informacji o rolach logowania znajdziesz w przewodniku kontroli dostępu.
Podczas dodawania i konfigurowania rozszerzenia przy użyciu dokumentu dotyczącego konfiguracji użyj zawartości powstałego klucza pliku JSON.
Informacje o usłudze Stackdriver Logging
Stackdriver Logging jest częścią pakietu usług Stackdriver w Google Cloud Platform (GCP). Obejmuje miejsce na logi, interfejs użytkownika o nazwie Przeglądarka logów oraz interfejs API, który umożliwia programowe zarządzanie logami. Usługa Stackdriver Logging pozwala odczytywać i zapisywać wpisy logu, przeszukiwać i filtrować logi, eksportować logi oraz tworzyć wskaźniki oparte na logach.
To rozszerzenie obecnie zapisuje wpisy w dzienniku.
Więcej informacji znajdziesz w dokumentacji usługi Stackdriver Logging.
Sample
Poniższe przykłady pokazują, jak skonfigurować obsługę działań rozszerzenia Stackdriver Logging za pomocą zasady ExtensionCallout.
Dziennik globalny
Poniższa zasada zapisuje komunikat „To jest test” w logu o nazwie example-log w zasobie usługi Stackdriver Global. W rzeczywistym użyciu wiadomość prawdopodobnie zostałaby zawarta w zmiennej przepływu, której wartość została ustawiona w innym miejscu serwera proxy interfejsu 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>
Ta treść zawiera informacje na temat konfigurowania tego rozszerzenia i korzystania z niego. Instrukcje konfigurowania rozszerzenia w konsoli Apigee znajdziesz w artykule Dodawanie i konfigurowanie rozszerzenia.
Działania
log
Zapisuje komunikat w dzienniku.
To działanie zapisuje wpis logu usługi Stackdriver. Wpisy logu składają się z metadanych i danych wpisu. Więcej informacji o wpisach w dzienniku znajdziesz w dokumentacji wpisu. Informacje o zawartości właściwości metadata
znajdziesz w sekcji dotyczącej obiektu LogEntry w dokumentacji usługi Stackdriver Logging.
Składnia
<Action>log</Action>
<Input><![CDATA[{
"logName" : "stackdriver-log-name-to-use",
"metadata" : JSON-structured-metadata,
"message" : "data-to-log-as-entry"
}]]></Input>
Przykład: ciąg znaków
<Action>log</Action>
<Input><![CDATA[{
"logName" : "example-log",
"metadata" : { "resource" : { "type" : "global" } },
"message": "This is a test."
}]]></Input>
Przykład: JSON
<Action>log</Action>
<Input><![CDATA[{
"logName" : "example-log",
"metadata" : { "resource" : { "type" : "global" } },
"message" : { "info" : "This is a test." }
}]]></Input>
Parametry żądania
Parametr | Opis | Typ | Domyślne | Wymagane |
---|---|---|---|---|
logName | Nazwa dziennika, do którego należy ten wpis. | Ciąg znaków | Brak. | Tak. |
metadane | Metadane wpisu logu. Więcej informacji i informacji o ustawieniach type i labels w usłudze metadata znajdziesz w artykule MonitoredResource. |
JSON | Brak. | Nie. |
wiadomość | Dane do użycia jako wartość tego wpisu logu. Możesz podać prosty ciąg lub użyć formatu JSON, aby zapisać bardziej uporządkowaną wiadomość. | Ciąg tekstowy lub JSON | Brak. | Tak. |
Odpowiedź
Brak, jeśli wiadomość została zapisana w dzienniku. W przeciwnym razie żądanie zwróci błąd. Zobacz też Debugowanie rozszerzenia.
Dokumentacja konfiguracji
Skorzystaj z podanych niżej instrukcji podczas konfigurowania i wdrażania tego rozszerzenia na potrzeby serwerów proxy interfejsów API.
Typowe właściwości rozszerzeń
Dla każdego rozszerzenia dostępne są poniższe właściwości.
Usługa | Opis | Domyślnie | Wymagany |
---|---|---|---|
name |
Nazwa nadana konfiguracji rozszerzenia. | Brak | Tak |
packageName |
Nazwa pakietu rozszerzeń podana przez Apigee Edge. | Brak | Tak |
version |
Numer wersji pakietu rozszerzenia, z którego konfigurujesz rozszerzenie. | Brak | Tak |
configuration |
Wartość konfiguracji specyficzna dla dodawanego rozszerzenia. Zobacz Właściwości tego pakietu rozszerzeń | Brak | Tak |
Właściwości tego pakietu rozszerzeń
Podaj wartości następujących właściwości konfiguracji specyficznych dla tego rozszerzenia.
Właściwość | Opis | Domyślne | Wymagane |
---|---|---|---|
projectId | Identyfikator projektu GCP, w którym mają być tworzone logi. | Brak. | Tak. |
dane logowania | Wpisana w konsoli Apigee Edge jest to zawartość pliku klucza konta usługi. Gdy jest wysyłana przez interfejs API zarządzania, jest to wartość zakodowana w formacie base64 wygenerowana z pliku klucza konta usługi. | Brak. | Tak. |