Informations détaillées sur le service de stockage d'objets

Détails de la journalisation pour les journaux du service de stockage d'objets.

Ressources

  • seaux

Catégories de journaux

Valeur d'API (ID) : Console (Nom d'affichage) Description
write Write Access Events Inclut les journaux pour les événements d'écriture.
read Read Access Events Inclut les journaux pour les événements de lecture.

Disponibilité

La journalisation pour le service Stockage d'objets est disponible dans toutes les régions des domaines commerciaux.

Commentaires

Choisissez la catégorie de journal correspondant au type d'informations à enregistrer. Par exemple, si vous activez un journal d'écriture, la propriété requestAction contient les valeurs PUT, POST ou DELETE. Si vous activez un journal de lecture, requestAction contiendrait les valeurs GET, LIST ou HEAD.

Note

Les journaux du service Stockage d'objets sont livrés au mieux. Dans des situations limitées, un petit nombre d'entrées de journal peuvent ne pas être livrées.

Contenu d'un journal du service de stockage d'objets

Propriété Description
additionalDetails

Inclut les champs suivants, le cas échéant, pour un journal particulier :

  • versionId : À partir des réponses PutObject et DeleteObject
  • isDeleteMarker : À partir de la réponse DeleteObjectVersion
  • retentionRuleName
apiType API du service Stockage d'objets d'origine :
  • native
  • compatible s3
  • swift
authenticationType Type d'authentification de demande :
  • utilisateur
  • service
  • ressource
  • instance
bucketCreator OCID du créateur de seau
bucketId OCID du seau
bucketName Nom du seau
clientIpAddress Adresse IP du client ayant effectué la demande.
compartmentId OCID du compartiment
compartmentName Nom du compartiment
credentials Données d'identification de la sécurité des demandes
endTime Horodatage de fin de demande
errorCode Le cas échéant, un code d'erreur court destiné à l'analyse par programmation qui définit l'erreur.
eTag Marqueur d'entité (ETag) pour la ressource
isPar Valeur booléenne décrivant s'il s'agit d'une demande préauthentifiée :
  • Vrai
  • Faux
message Chaîne lisible par l'utilisateur décrivant la demande
namespace Espace de noms du service Stockage d'objets utilisé pour la demande
objectName Nom de l'objet
opcRequestId ID demande client pour le traçage
principalId OCID du demandeur
principalName Nom du demandeur
region Identificateur de la région
requestAction Méthode HTTP de la demande (DELETE/GET/HEAD/POST/PUT)
requestResourcePath Chemin de ressource de la demande
startTime Horodatage de début de demande
statusCode Code de statut de réponse
tenantId OCID du locataire
tenantName OCID du locataire
userAgent Agent utilisateur qui a envoyé la demande au service Stockage d'objets

Exemple de journal du service Stockage d'objets

{
   "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>",
    }
}

Nom d'objet de journal du service de stockage d'objets

Les objets qui stockent les données du service de stockage d'objets utilisent le format d'attribution de nom suivant :

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

Par exemple :

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

Utilisation de l'interface de ligne de commande (CLI)

Voir Exemple pour le service de stockage d'objets pour des exemples de commandes.