Encaminhar registros para um serviço

Por que devo configurar o encaminhamento de registros?

Considere configurar um encaminhador de registros se você precisar fazer qualquer uma das seguintes ações:

• Armazene registros por mais tempo do que o período de retenção do App Services de 10 dias.

• Integrar registros em um serviço de registro externo

• Acessar registros no Atlas Search, Atlas Online Archive e Charts

Como o encaminhamento de registros é cobrado?

Cada invocação de ação de encaminhamento de registro (em um registro individual ou em lote) é cobrada como uma solicitação do App Services.

1. Criar um encaminhador de registros

{
  "name": "<name>"
}

2. Escolha quais registros encaminhar

O App Services pode encaminhar todos os logs do seu aplicativo ou enviar somente um subconjunto para a collection ou serviço de destino. Você controla esse subconjunto para cada encaminhador de registro definindo filtros para o tipo de registro (por exemplo funções, sincronização, etc.) e status (ou seja, sucesso ou erro) que invocam a ação do encaminhador.

App Services UI

CLI de serviços de aplicativos

Escolha um ou mais tipos de registro para encaminhar no menu suspenso Log Type :

Escolha um ou mais status para encaminhar no menu suspenso Log Status :

Especifique um ou mais tipos e um ou mais status para o encaminhador corresponder e encaminhar:

/log_forwarders/<name>.json

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

O App Services suporta o encaminhamento dos seguintes tipos de registro:

• auth

• endpoint

• function

• graphql

• push

• schema

• service

• sync

• trigger

• trigger_error_handler

O App Services suporta o encaminhamento dos seguintes status de registro:

• error

• success

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

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

3. Configurar agrupamento de registros em lote

O App Services pode combinar vários registros em uma única solicitação em lote para reduzir a sobrecarga. A maneira como os grupos do App Services fazem login em lotes é controlada por uma política de lote.

O App Services oferece suporte às seguintes políticas de lote:

• Sem lote: o App Services encaminha os registros individualmente à medida que suas solicitações correspondentes ocorrem.

• Lote: o encaminhador agrupa documentos em um lote conforme eles acontecem. Cada lote pode incluir até 100 entradas de registro. Quando um lote está cheio, o App Services encaminha todo o lote em uma única solicitação. O App Services encaminha os registros pelo menos uma vez por minuto, independentemente do número de registros no lote atual.

App Services UI

CLI de serviços de aplicativos

Para configurar o lote, selecione a política No batch ou Batching .

Para configurar o lote, especifique o tipo de política, single ou batch, no campo policy :

/log_forwarders/<name>.json

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

5. Definir uma ação

Um encaminhador de registros pode armazenar registros automaticamente em uma coleção MongoDB vinculada ou chamar uma função personalizada que envia os registros para um serviço externo.

Armazenar registros em uma collection MongoDB

App Services UI

CLI de serviços de aplicativos

Para armazenar registros em uma collection, selecione a ação To Collection e insira os nomes do cluster vinculado, do reconhecimento de data center e da collection que devem manter os registros encaminhados.

Para armazenar registros em uma collection, especifique um action do tipo collection que inclui os nomes do cluster vinculado, banco de dados de dados e collection que devem manter os registros encaminhados.

/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. Salve e implemente suas alterações

appservices push