Configurazione del componente programma di analisi per un programma di analisi basato su regole

Prerequisiti:

Il ruolo del programma di analisi consiste nel prendere i messaggi delimitati dall'estrattore e generare un insieme di associazioni di valori della stringa agli attributi di Common Base Event.

Per configurare il componente programma di analisi, è necessario configurare le regole per i due livelli di esecuzione del programma di analisi:

Elaborazione globale - un insieme di regole di espressioni regolari globali eseguite per i risultati dei messaggi forniti dall'estrattore
Elaborazione attributi - insiemi specifici di regole di sostituzione vengono eseguiti per stabilire il valore da assegnare a ciascun attributo di Common Base Event specificato nell'editor.

Configurazione delle regole per l'elaborazione globale

Nel riquadro di sinistra dell'Editor configurazione adattatore, selezionare Configurazione > Istanza di contesto > Programma di analisi. Il riquadro di destra visualizza le informazioni sul programma di analisi.
Immettere la descrizione del programma di analisi nel campo Descrizione.
Se i record di log contengono token di separazione che delimitano gli elementi in un record, immettere il token nel campo Token di separazione. Ad esempio, per il record di log dell'applicazione myapp, il token di separazione tra gli elementi è un doppio spazio:
```
<March 14, 2004 10:25:21 EST>  application:myapp  severity:3  message:WARNING-file style.css missing
```
Il token di separazione può essere specificato con l'espressione regolare [ ]{2}.
Se i record di log contengono elementi in un modello coppia nome-valore, è possibile specificare il token che associa il nome al valore nel campo Token di designazione. Utilizzando il suddetto esempio, nel record di log myapp, il token di designazione è rappresentato da due punti : .

Configurazione delle regole per l'elaborazione attributi

La seconda fase di esecuzione nel programma di analisi applica determinate regole di sostituzione per identificare i valori da assegnare agli attributi di Common Base Event.

Aggiunta e configurazione degli attributi di Common Base Event

Sono necessari i seguenti attributi di Common Base Event:

creationTime
situation
sourceComponentID

Per un elenco completo di attributi di Common Base Event, fare riferimento al Modello di Common Base Event.

Nel riquadro di sinistra dell'Editor configurazione adattatore, selezionare Configurazione > Istanza di contesto > Programma di analisi > Common Base Event. Il riquadro di destra visualizza le informazioni su Common Base Event.
Per aggiungere un nuovo attributo, fare clic con il tasto destro del mouse sul nodo Common Base Event e selezionare l'attributo da aggiungere dal menu a comparsa. L'attributo viene creato nel nodo Common Base Event. Nel seguente esempio, viene aggiunto l'attributo msg.
Per configurare l'attributo appena aggiunto, selezionarlo. I dettagli sull'attributo verranno visualizzati nel riquadro di destra.
Utilizzando il suddetto esempio, se i record di log non contengono tutti l'attributo msg, è possibile selezionare la casella di controllo Utilizzare come impostazione predefinita la sostituzione precedente corrispondente. In questo modo verrà assegnato il valore dell'ultimo messaggio corrispondente all'attributo msg.
Se si desidera impostare un valore predefinito per msg, immettere il valore nel campo Valore predefinito. Questo valore predefinito verrà utilizzato solo se non esistono regole di sostituzione o se non corrispondono, se Utilizzare come impostazione predefinita la sostituzione precedente corrispondente non è selezionata o, se è selezionata, non esiste un valore corrispondente precedente salvato.
Continuare ad aggiungere tutti gli attributi necessari ripetendo la stessa procedura.

Aggiunta e configurazione delle regole di sostituzione attributi

Per aggiungere una regola di sostituzione all'attributo di Common Base Event, selezionare Attributo > Aggiungi > Regola di sostituzione. I dettagli della regola di sostituzione vengono visualizzati nel riquadro di destra dell'editor.

Il campo Posizioni può essere utilizzato quando il record di log contiene le coppie nome-valore delimitate da un token. Il valore di una coppia nome-valore può essere estratto utilizzando l'atomo $h('nameofNameValuePair').
Ad esempio, utilizzando lo stesso record di log dell'applicazione myapp:
```
<March 14, 2004 10:25:21 EST>  application:myapp  severity:3  message:WARNING-file style.css missing
```
con il token di separazione = []{2} e il token di designazione = : , l'atomo per estrarre il messaggio sarà $h('message').
Per altre applicazioni del campo Posizioni, consultare l'argomento Campo Posizioni.
La Corrispondenza specifica un modello da cercare nel record. Se il campo Posizioni viene specificato, verrà cercata una parte del record, in caso contrario, verrà cercato l'intero record per il modello specificato. In questo modello, alcuni dati possono essere raggruppati utilizzando le parentesi indicate nel campo Sostituzione. Se il modello associa i dati nel record, all'attributo di Common Base Event, per il quale esiste questa regola, verrà assegnato un valore in base al campo Sostituzione. Se il campo viene lasciato vuoto, la regola verrà considerata una corrispondenza.
Nell'esempio del record di log myapp, per associare il valore del messaggio estratto dal campo Posizioni, può essere utilizzata la seguente espressione regolare:
```
^(\w+)-(.*)
```
Questo modello di corrispondenza contiene due gruppi. Il primo è un insieme di caratteri di parole prima di un trattino. Il secondo è composto da tutto ciò che compare dopo il trattino fino alla fine del messaggio come definito dalla specifica del campo Posizioni.
Il campo Sostituzione è il valore da assegnare all'attributo di Common Base Event come risultato di una corrispondenza. I valori possono essere estratti dalla stringa corrispondente utilizzando i valori letterali $1, $2 ecc. raffiguranti ciascuno i gruppi nel modello di corrispondenza.
Nell'esempio del record di log myapp, se si desidera assegnare il valore dell'avviso all'attributo msg di Common Base Event, specificare la sostituzione come $2.
La Classe di estensione della sostituzione può essere utilizzata se si desidera eseguire una logica di analisi personalizzata sul valore corrispondente ai campi Posizioni, Corrispondenza e Sostituzione. La classe utente deve implementare l'interfaccia dell'Adattatore di log generico
```
classorg.eclipse.hyades.logging.adapter.parsers.ISubstitutionExtension 
```
per poter essere eseguita dallo stesso Adattatore di log generico.
Il campo Formato ora può essere utilizzato per creare una regola di sostituzione per l'attributo creationTime. Specificare una stringa del modello di tempo Java in questo campo. Il modello immesso verrà utilizzato per analizzare il valore corrispondente ai campi Posizioni, Corrispondenza e Sostituzione, utilizzando la classe java.text.SimpleDateFormat per generare la data come un valore esteso. Questo valore viene quindi utilizzato per generare il valore della stringa della data nel formato dateTime dello Schema XML richiesto da Common Base Event.
Nell'esempio del record di log myapp, la regola Formato ora sarà:
Applicare le modifiche apportate salvando il file di configurazione dell'adattatore.
Per verificare le regole, fare clic su Esegui di nuovo l'adattatore per eseguire l'adattatore. I risultati verranno mostrati nella vista Risultato programma di formattazione.
Fare clic sull'icona Mostra evento successivo per visualizzare gli attributi di Common Base Event generati utilizzando le regole scritte.

Nota: Per ulteriori informazioni sul formato della data semplice Java, consultare il javadoc java.sun.com/j2se/1.4.2/docs/api/java/text/SimpleDateFormat.html.

Una volta completate le regole del programma di analisi, è possibile configurare il componente programma di creazione output del file di configurazione dell'adattatore.

Argomenti correlati
Panoramica dell'Adattatore di log generico Hyades
Specifica del formato di Common Base Event

Attività correlate
Creazione di un programma di analisi del log
Creazione di un adattatore basato su regole
Configurazione del componente programma di creazione output

Riferimenti correlati
Struttura del file di configurazione dell'adattatore
Editor configurazione adattatore
Grammatica espressione regolare
Esempi di regole di sostituzione