Google Cloud Logging 확장 프로그램

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보

버전 1.6.0

Cloud Logging 로그에 항목을 작성합니다.

이 콘텐츠는 이 확장 프로그램을 구성하고 사용하기 위한 참조를 제공합니다.

기본 요건

API 프록시에서 이 확장 프로그램을 사용하려면 먼저 다음 작업을 수행해야 합니다.

1. IAM에서 로깅 > Cloud Logging 시스템에 대한 확장 프로그램을 나타내는 프로젝트 구성원에게 로그 작성자 역할을 부여합니다. 역할을 부여하는 방법에 대한 안내는 서비스 계정에 특정 리소스에 대한 역할 부여하기를 참고하세요. 역할 로깅에 대한 자세한 내용은 액세스 제어 가이드를 참조하세요.

2. Google Cloud 콘솔을 사용하여 서비스 계정의 키를 생성합니다.

3. 구성 참조를 사용하여 확장 프로그램을 추가 및 구성할 때 결과 키 JSON 파일의 콘텐츠를 사용합니다.

이 광고 확장은 PostClientFlow에 있는 Extension콜아웃 정책을 통한 호출을 지원합니다. 확장 콜아웃 정책을 사용하여 PostClientFlow에서 features.allowExtensionsInPostClientFlow 플래그가 조직에서 true(으)로 설정되어 있습니다.

• 퍼블릭 클라우드용 Apigee Edge 고객인 경우 Apigee Edge 지원팀에 문의하여 조직에서 features.allowExtensionsInPostClientFlow 플래그가 true로 설정되어 있습니다.

• 프라이빗 클라우드용 Apigee Edge 고객은 조직 속성 업데이트 API features.allowExtensionsInPostClientFlow 플래그를 true로 설정합니다.

Cloud Logging 정보

Cloud Logging은 Google Cloud의 운영 제품군을 예로 들 수 있습니다 여기에는 로그 스토리지인 로그라고 하는 사용자 인터페이스가 포함되어 있습니다. 프로그래매틱 방식으로 로그를 관리하는 API가 포함됩니다. Cloud Logging을 사용하면 다음을 수행할 수 있습니다. 로그 항목 읽기 및 쓰기, 로그 검색 및 필터링, 로그 내보내기, 로그 기반 측정항목을 만들 수 있습니다

Cloud Logging 확장 프로그램은 현재 로그에 항목을 씁니다. 자세한 내용은 Cloud Logging 문서를 참조하세요.

샘플

다음 예시는 Cloud Logging 지원을 구성하는 방법을 보여줍니다. Extension콜아웃 정책을 사용하여 광고 확장 작업을 관리할 수 있습니다.

전역 로그

다음 정책은 This is a test 메시지를 Cloud 전역 리소스의 example-log 실제로 사용하는 경우 아마도 다른 곳에서 설정한 값이 있는 흐름 변수에 메시지가 포함되어야 합니다. 를 사용합니다.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Logging-Extension">
    <DisplayName>Logging Connector</DisplayName>
    <Connector>cloud-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 콘솔을 사용하여 확장 프로그램을 구성하는 단계는 다음을 참조하세요. 확장 프로그램 추가 및 구성

작업

로그

로그에 메시지를 작성합니다.

이 작업은 Cloud Logging 로그 항목을 작성합니다. 로그 항목은 메타데이터로 구성됨 입력 데이터입니다. 로그 항목에 대한 자세한 내용은 항목 참조. metadata 속성의 콘텐츠에 관한 자세한 내용은 LogEntry 객체를 참조하세요.

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

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "example-log",
  "metadata" : { "resource" : { "type" : "global" } },
  "message": "This is a test."
}]]></Input>

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "example-log",
  "metadata" : { "resource" : { "type" : "global" } },
  "message" : { "info" :  "This is a test." }
}]]></Input>

요청 매개변수

응답

메시지가 로그에 기록된 경우 None 그렇지 않으면 요청에서 오류를 반환합니다. 확장 프로그램 디버깅도 참고하세요.

구성 참조

API 프록시에서 사용하기 위해 이 확장 프로그램을 구성하고 배포할 때 다음을 사용하세요.

일반적인 확장 속성

모든 확장 프로그램에는 다음과 같은 속성이 있습니다.

이 확장 프로그램의 속성

이 확장 프로그램과 관련된 다음 구성 속성의 값을 지정합니다.