서비스에 로그 전달

로그 전달을 구성해야 하는 이유는 무엇인가요?

다음 중 하나를 수행해야 하는 경우 로그 전달자를 설정하는 것이 좋습니다.

• App Services의 보존 기간인 10일보다 오랫동안 로그를 저장합니다.

• 외부 로깅 서비스에 로그 통합

• Atlas Search, Atlas Online Archive 및 Atlas Charts의 로그에 액세스

로그 전달 요금은 어떻게 청구되나요?

개별 로그 또는 배치에서 각 로그 전달 조치 호출은 하나의 App Services 요청으로 청구됩니다.

1. 로그 전달자 만들기

{
  "name": "<name>"
}

2. 전달할 로그 선택

App Services는 앱의 모든 로그를 전달하거나 대상 collection 또는 서비스에 하위 집합만 보낼 수 있습니다. 로그 유형에 대한 필터를 정의하여 각 로그 전달자에 대해 이 하위 집합을 제어합니다(예: 기능, 동기화 등) 및 상태(예: 성공 또는 오류)의 경우 포워더의 조치를 호출합니다.

App Services UI

앱 서비스 CLI

Log Type 드롭다운에서 전달할 로그 유형을 하나 이상 선택합니다.

Log Status 드롭다운에서 전달할 상태를 하나 이상 선택합니다.

포워더가 일치시켜 전달할 하나 이상의 유형과 하나 이상의 상태를 지정합니다.

/log_forwarders/<name>.json

{
  "name": "<name>",
  "log_types": [ "<type>", ... ],
  "log_statuses": [ "<status>", ... ]
}

App Services 는 다음 로그 유형 전달을 지원합니다.

• auth

• endpoint

• function

• graphql

• push

• schema

• service

• sync

• trigger

• trigger_error_handler

App Services 는 다음 로그 상태 전달을 지원합니다.

• error

• success

{ "type": "sync", "status": "error", ... }

{ "type": "sync", "status": "success", ... }
{ "type": "schema", "status": "error", ... }

3. 로그 배치 구성

App Services는 여러 로그인을 단일 배치 요청으로 결합하여 오버헤드를 줄일 수 있습니다. App Services가 로그를 배치로 그룹화하는 방식은 배치 정책에 의해 제어됩니다.

App Services는 다음과 같은 배치 정책을 지원합니다.

• 배치 없음: App Services에서 해당 요청이 발생할 때 로그를 개별적으로 전달합니다.

• 배치: 포워더는 문서를 배치로 그룹화합니다. 각 배치에는 최대 100개의 로그 항목이 포함될 수 있습니다. 배치가 가득 차면 App Services는 단일 요청으로 전체 배치를 전달합니다. App Services는 현재 배치의 로그 수에 관계없이 1분에 한 번 이상 로그를 전달합니다.

App Services UI

앱 서비스 CLI

배치를 구성하려면 No batch 또는 Batching 정책을 선택합니다.

일괄 처리를 구성하려면 policy 필드 에 정책 유형 single 또는 batch 을 지정합니다.

/log_forwarders/<name>.json

{
  "name": "<name>",
  "log_types": [ "<type>", ... ],
  "log_statuses": [ "<status>", ... ],
  "policy": { "type": "<single|batch>" }
}

5. 조치 정의

로그 전달자는 연결된 MongoDB collection에 로그를 자동으로 저장하거나 로그를 외부 서비스로 전송하는 사용자 지정 함수를 호출할 수 있습니다.

MongoDB collection에 로그 저장

App Services UI

앱 서비스 CLI

컬렉션에 로그를 저장하려면 To Collection 작업을 선택하고 전달된 로그를 보관해야 하는 연결된 클러스터, 데이터베이스 및 컬렉션의 이름을 입력합니다.

컬렉션 에 로그를 저장 하려면 전달된 로그를 보관해야 하는 연결된 클러스터, 데이터베이스 및 컬렉션 의 이름을 포함하는 collection 유형의 action 를 지정합니다.

/log_forwarders/<name>.json

{
  "name": "<name>",
  "log_types": [ "<type>", ... ],
  "log_statuses": [ "<status>", ... ],
  "policy": { "type": "<single|batch>" },
  "action": {
    "type": "collection",
    "data_source": "<data source name>",
    "database": "<database name>",
    "collection": "<collection name>"
  }
}

exports = async function(logs) {
  // `logs` is an array of 1-100 log objects
  // Use an API or library to send the logs to another service.
  await context.http.post({
    url: "https://api.example.com/logs",
    body: logs,
    encodeBodyAsJSON: true
  });
}

{
  "name": "<name>",
  "log_types": [ "<type>", ... ],
  "log_statuses": [ "<status>", ... ],
  "policy": { "type": "<single|batch>" },
  "action": {
    "type": "function",
    "name": "<function name>"
  }
}

6. 변경 사항 저장 및 배포

appservices push