Detalhes do Serviço Object Storage

Detalhes de log para logs do serviço Object Storage.

Recursos

  • buckets

Categoria de Log

Valor da API (ID): Console (Nome para Exibição) Descrição
write Eventos de Acesso de Gravação Inclui logs para eventos de gravação.
read Eventos de Acesso de Leitura Inclui logs para eventos de leitura.

Disponibilidade

O log do serviço Object Storage está disponível em todas as regiões dos realms comerciais.

Comentários

Escolha a categoria de log para o tipo de informação que você deseja registrar. Por exemplo, se você ativar um log de gravação, a propriedade requestAction conterá valores PUT, POST ou DELETE. Se você ativar um log de leitura, requestAction conterá valores GET, LIST ou HEAD.

Observação

Os logs de serviço do serviço Object Storage são entregues com base no melhor esforço. Em situações limitadas, um pequeno número de entradas de log não pode ser entregue com sucesso.

Conteúdo de um Log do Serviço Object Storage

Propriedade Descrição
additionalDetails

Inclua os seguintes campos quando aplicável ao log específico:

  • versionId: De respostas PutObject e DeleteObject
  • isDeleteMarker: Na resposta DeleteObjectVersion
  • retentionRuleName
apiType API do Armazenamento de Objetos de origem:
  • nativo
  • compatível com s3
  • swift
authenticationType Tipo de autenticação de solicitação:
  • usuário
  • serviço
  • recurso
  • instância
bucketCreator OCID do criador do bucket
bucketId OCID do bucket
bucketName Nome do bucket
clientIpAddress Endereço IP do cliente solicitante
compartmentId OCID do compartimento
compartmentName Nome do compartimento
credentials Credenciais de segurança da solicitação
endTime Timestamp final da solicitação
errorCode Se estiver presente, um código de erro curto destinado a parsing programático que define o erro
eTag Tag de entidade (ETag) para o recurso
isPar Um booliano que descreva se esta é uma solicitação pré-autenticada:
  • verdadeiro
  • falso
message String legível que descreve a solicitação
namespace Namespace do serviço Object Storage usado para a solicitação
objectName O nome do objeto
opcRequestId ID da solicitação do cliente para rastreamento
principalId OCID do solicitante
principalName Nome do solicitante
region Identificador da região
requestAction Método HTTP da solicitação (DELETE/GET/HEAD/POST/PUT)
requestResourcePath Caminho do recurso da solicitação
startTime Timestamp inicial da solicitação
statusCode Código de status de resposta
tenantId OCID do tenant
tenantName OCID do tenant
userAgent Agente do Usuário que enviou a solicitação ao serviço Object Storage

Um Exemplo de Log do Serviço Object Storage

{
   "time": "2020-09-10T19:04:11.324Z",
   "specversion": "1.0",
   "id": "2901893c-2140-491e-b23d-9cc6649fce67",
   "source": "MyBucket",
   "subject": "MyObject",
   "type": "com.oraclecloud.objectstorage.putobject",
    "data": {
      "additionalDetails": {
        "versionId": "7dec129d-ec60-470f-a153-f44af0ac15a6"
      },
      "apiType": "native",
      "authenticationType": "user",
      "bucketCreator": "ocid1.user.oc1..<unique_ID>",
      "bucketId": "ocid1.bucket.oc1.phx.<unique_ID>",
      "bucketName": "MyBucket",
      "clientIpAddress": "203.0.113.4",
      "compartmentId": "ocid1.compartment.oc1..<unique_ID>",
      "compartmentName": "MyObjectStore",
      "credentials": "<credentials>",
      "endTime": "2020-09-10T19:04:11.324Z",
      "isPar": false,
      "message": "Object uploaded.",
      "namespaceName": "MyNamespace",
      "objectName": "MyObject",
      "opcRequestId": "phx-1:7Tx5sjOAXOlcWKX5F-1Wjz_W2zF8aIeqW8PepNgsKHRlqKm3Mrot9IJAuZbQxBEI",
      "principalId": "ocid1.user.oc1..<unique_ID>",
      "principalName": "jane.smith@example.com",
      "region": "us-phoenix-1",
      "requestAction": "PUT",
      "requestResourcePath": "/n/MyNamespace/b/MyBucket/o/MyObject",
      "startTime": "2020-09-10T19:04:10.679Z",
      "statusCode": 200,
      "tenantId": "ocid1.tenancy.oc1..<unique_ID>",
      "tenantName": "MyTenancy",
      "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36"
    },
    "oracle": {
      "logid": "ocid1.log.oc1.phx.<unique_ID>",
    }
}

Nome do Objeto de Log do Serviço Object Storage

Os objetos que armazenam dados do serviço Object Storage usam o seguinte formato de nomenclatura:

public_log/<bucket_name>/<YYYY-MM-DDTHH_MMZ>[_<seqNum>].log.gz

Por exemplo:

public_log/example_bucket/2019-03-21T00_00Z.log.gz
public_log/example_bucket/2019-03-21T00_00Z_2.log.gz

Usando a Interface de Linha de Comando (CLI)

Consulte Exemplo de Armazenamento de Objetos para ver exemplos de comandos.