Documentação do Oracle Cloud Infrastructure

Logs Personalizados

Logs personalizados são logs que contêm informações de diagnóstico de aplicativos personalizados, outros provedores de nuvem ou um ambiente local.

Os logs personalizados podem ser ingeridos das seguintes maneiras:

Os logs personalizados podem ser exibidos na página da instância do Oracle Cloud Infrastructure Compute e possuem um recurso de Logs associado. Eles também podem ser exibidos na página Pesquisar do Registro em Log, na página Logs ou em uma página de detalhes de Grupos de Logs associada. Os logs personalizados também são suportados em instâncias bare metal.

Observação

Você também pode exibir a taxa na qual os logs personalizados estão sendo aceitos e ingeridos usando o serviço Oracle Cloud Infrastructure Monitoring. Consulte Exibindo a Taxa de Aceitação de Logs Personalizados para obter mais informações.

O Agente de Monitoramento Unificado pode ser instalado em muitas máquinas, e ele extrai logs de diretórios locais, nos quais seus aplicativos ou sistemas emitem logs. O agente também pode fazer parsing de seus logs para você. Tudo isso está configurado em Configurações do Agente. Você pode criar uma configuração de agente separadamente e depois associar um log personalizado a ela ou pode criar um log personalizado e criar a configuração de agente posteriormente.

A configuração de um agente é o mecanismo central para definir:
  • De quais hosts você deseja logs.
  • Quais logs específicos você deseja dos hosts.
  • Parsers adicionais.
  • O destino do log personalizado.

A criação de um log personalizado é um processo de duas etapas, no qual você cria primeiro o objeto de log personalizado e, em seguida, cria sua configuração de agente associada. Consulte Criando um Log para obter mais informações sobre como criar logs personalizados e configurações do agente e Visão Geral do Gerenciamento de Agentes para obter mais informações sobre como configurar e gerenciar o agente.

Observação

Para que o agente seja executado corretamente, certifique-se de que as definições de firewall permitam os seguintes pontos finais de URI:
  • https://auth.<sua região>.oraclecloud.com
  • https://ingestion.logging.<sua região>.oci.oraclecloud.com.

Metadados de Log Personalizados e Carregamento de Armazenamento

Metadados de log personalizados são adicionados durante a ingestão em dois locais para otimizar os custos de armazenamento:

  • No nível de solicitação
  • No nível da linha de log

Uma solicitação é uma coleção de linhas de log, e a solicitação pode incluir uma ou mais linhas de log nela. Essas solicitações podem incluir um lote de linhas de log que foram ingeridas e, em seguida, chamadas subsequentes para ingerir linhas de log adicionais podem ocorrer. Uma solicitação também pode ter uma quantidade diferente de linhas de log, dependendo de como os clientes estão enviando dados. Os clientes são cobrados apenas uma vez pelos metadados no nível da solicitação. Como linhas de log adicionais em uma solicitação são ingeridas, nenhuma cobrança adicional é incorrida neste nível. Os metadados da solicitação se aplicam a todas as linhas de log em uma solicitação no nível da solicitação, em vez de adicionar metadados adicionais a cada linha de log, o que ajuda a economizar nos custos de armazenamento.

A seguir estão exemplos de metadados no nível da solicitação:

{
"oracle":{
"compartmentid":"ocid1.compartment.oc1..<unique_id>",
"ingestedtime":"2022-05-23T18:00:04.073Z",
"loggroupid":"ocid1.loggroup.oc1.iad.<unique_id>",
"logid":"ocid1.log.oc1.iad.<unique_id>",
"tenantid":"ocid1.tenancy.oc1..<unique_id>"
},
"source":"<customer_data>",
"specversion":"1.0",
"subject":"<customer_data>",
"type":"<customer_data>"
}

O tamanho mínimo dos metadados da solicitação é 500 bytes, mas o valor pode variar dependendo do tamanho dos dados do cliente nos campos source, subject e type. O tamanho total dos metadados pode variar dependendo dos dados específicos do cliente nesses campos.

No nível da linha de log, que contém o payload de log real, os seguintes metadados de 100 byte são adicionados para cada linha de log:

{
"data":{
<log payload>
},
"id":"fb1f6b06-4ed5-4133-a1d0-ad2ffc3addc6",
"time":"2022-05-23T11:54:30.532Z",
}

Os id e time são obrigatórios e indicam o evento de log correspondente, juntamente com o tempo de criação.

Por exemplo (considerando dados vazios nos campos source, subject e type), se o Agente de Monitoramento Unificado do Oracle Cloud Infrastructure Logging receber uma solicitação com 100 linhas de log, em que cada linha de log tinha 1 KB de tamanho, o tamanho total dos metadados adicionados será de cerca de 10,5 KB por o seguinte cálculo:
  • Nível de solicitação: 500 bytes
  • Nível de linha de log: 100 (número de linhas de log em uma solicitação) * 100 bytes (cada metadados de linha de log) = 10 KB

A quantidade total de linhas de log enviadas neste exemplo de solicitação é 100 * 1 KB = 100 KB. Após a adição dos metadados, o tamanho do armazenamento de log resultante será de 110,5 KB.