Il partizionamento dei log è disponibile in tutte le aree e i realm in cui è disponibile Oracle Logging Analytics.

Se il caso d'uso in uso richiede la funzione di partizionamento, inviare un file Service Request con il Supporto Oracle che richiede questa funzione in Oracle Logging Analytics.

È possibile raccogliere i log tramite Management Agent standalone o utilizzarli come parte dell'agente Oracle Cloud.

1. Esistono diversi modi per definire il set di log modificando il file emd.properties per il Management Agent. Selezionare una delle opzioni riportate di seguito.

   • È possibile impostare un valore di set di log statico per tutti i log raccolti dall'agente. Aggiungere la proprietà seguente al file emd.properties dell'agente per specificare il set di log a livello di agente:

     loganalytics.src.addl_src_ptn_configs=logset=<Value>

   • Impostare il valore del set di log come parte del nome del file di log. Nella configurazione dell'agente è possibile specificare un'espressione regolare per definire come estrarre parte del percorso del file di log la stringa del set di log. Nel file di configurazione emd.properties dell'agente, specificare le proprietà logsetkey e logSetExtRegex:

     loganalytics.src.addl_src_ptn_configs=logsetkey=logorigin,logSetExtRegex=<regex with a capture group>

     logorigin è il percorso del file di log.

   • È possibile specificare di applicare diverse estrazioni di set di log per ogni origine separatamente aggiungendo l'ID origine come proprietà alle impostazioni precedenti.

     //sets this log set value only for source 201904301
     loganalytics.src.addl_src_ptn_configs=srcid=201904301,logset=<Value>

     //sets this log set value based on regular expression extraction only for source 201904301
     loganalytics.src.addl_src_ptn_configs=srcid=201904301,logsetkey=logorigin,logSetExtRegex=<regex with a capture group>

2. Oltre a specificare il set di log utilizzando uno dei metodi descritti in precedenza, includere la proprietà seguente nel file di configurazione emd.properties:

   loganalytics.src.override_config=true

3. Riavviare l'agente dopo aver modificato il file di configurazione.

Al momento, questa funzione è supportata solo per i log personalizzati raccolti dal servizio di log OCI in Oracle Logging Analytics utilizzando l'hub connettore servizio.

Per impostare il valore del set di log, il log personalizzato deve aggiungere un nuovo campo al blocco data{} dei dati del formato di log unificato di registrazione OCI. Ad esempio:

{
  "data": {
    "logSet": "<Value>",
    ...
  },
  "oracle": {
    ...
  },
    ...
}

Quando si crea una regola di raccolta dello storage degli oggetti, sono applicabili le stesse opzioni utilizzate per popolare il set di log nella raccolta di Management Agent.

• È possibile impostare un valore di set di log statico per tutti i log raccolti da questa regola di raccolta dello storage degli oggetti. Aggiungere la proprietà seguente alla notazione JSON della regola di raccolta dello storage degli oggetti:

  {
      "name": "<Object Collection Rule Name>",
      "logSet": "<Value>",
      ...
  }

• È possibile specificare un'espressione regolare per analizzare il set di log dal percorso dell'oggetto. Ad esempio:

  {
      "name": "<Object Collection Rule Name>",
      "logSetExtRegex": "\\\/o\\\/[^\\\/]*\\\/([^\\\/]*)",
      ...
  }

• Se si utilizzano override nella regola di raccolta oggetti, è inoltre possibile impostare l'estrazione del set di log per l'override. Nell'esempio seguente, tutti i log raccolti dal bucket riceveranno il set di log Value1 ad eccezione degli oggetti che corrispondono all'override contenente db. Tali log riceveranno una stringa del set di log acquisita dall'espressione regolare nel percorso dell'oggetto.

  {
      "name": "<Object Collection Rule Name>",
      "logSet": "Value1",
      "overrides": {
          "items": [{
              "matchType": "contains",
              "matchValue": "db",
              "propertyName": "logSetExtRegex",
              "propertyValue": "\\\/o\\\/[^\\\/]*\\\/([^\\\/]*)"
          }]
      }
  }

Durante la contabilizzazione dei file di dati di log nell'endpoint API REST Eventi di log /actions/uploadLogEventsFile, è possibile specificare il set di log nei parametri di chiamata API REST POST. Tutti i dati di log caricati in questa singola chiamata API verranno memorizzati con lo stesso set di log.

Ad esempio:

POST /20200601/namespaces/<namespaceName>/actions/uploadLogEventsFile?logGroupId=<logGroup_OCID>&payloadType=JSON&logSet=<Value>

Quando si utilizza il raccoglitore fluentd, il set di log può essere estratto da qualsiasi altro campo (chiamata). Specificare un'espressione regolare che definisca come acquisire il valore del set di log previsto dal campo a cui fa riferimento key_name nel campo oci_la_log_set.

<filter oci.source>                  
  @type parser
  key_name oci_la_log_path      # The expression will be applied on the key "oci_la_log_path". You can pick any field that fluentd has parsed here.
  <parse>
    @type regexp
    expression '.*\/(?<oci_la_log_set>[^\.]{1,40}).*'   # Valid reg-ex for extraction
  </parse>
</filter>

Se il valore di oci_la_log_path è /n/axs4r325r2ct/b/logevents/o/fileType/logSetABC.log, il valore del set di log estratto in base all'espressione regolare precedente sarà logSetABC.