Registri di testo

 

Si applica a: System Center 2012 R2 Operations Manager, System Center 2012 - Operations Manager, System Center 2012 SP1 - Operations Manager

<_caps3a_sxs _xmlns3a_caps="https://schemas.microsoft.com/build/caps/2013/11"><_caps3a_sxstarget locale="it-IT">Oggetto Registro di testo è un file di testo che utilizza un'applicazione per registrare informazioni sugli eventi. Per utilizzare un'origine dati del Registro di testo in un management pack, ogni voce del registro deve essere su una singola riga. Se non si adatta questo requisito, il file di log un custom script deve essere creato per leggere il log.Le applicazioni che utilizzano spesso i file di log è creare un nuovo file ogni giorno o quando un file raggiunge dimensioni specifiche. Per supportare questa funzionalità, monitoraggi e regole per specificano un Directory e modello per i registri di testo da monitorare. Directory è il percorso della directory in cui verrà posizionati i registri di testo. Deve trattarsi di un percorso assoluto senza caratteri jolly. Inoltre è possibile utilizzare una variabile di $Target, se il percorso dei file di registro viene archiviato in una proprietà della classe di destinazione. Modello è il nome del file di log, compresi i caratteri jolly come appropriato.Ad esempio, un'applicazione potrebbe creare un file di log ogni giorno con la data inclusa nel nome come in log20100316.txt. Un modello per un log di questo tipo potrebbe essere log*.txt che potrebbero applicarsi a qualsiasi file di log dopo l'applicazione di schema di denominazione.Un registro di testo può essere definito come un Registro di testo generico o Registro testo CSV generico. CSV fa riferimento a valori delimitati da virgole, sebbene sia possibile specificare qualsiasi carattere come delimitatore. I due tipi di file sono anche denominati un Registro di testo semplice e Registro di testo delimitato da. Con un semplice file di testo, ogni riga viene considerata una singola voce. Con un log di testo delimitato, un singolo carattere viene utilizzato per separare i campi di dati diversi e ogni campo può essere analizzato separatamente.Procedure guidate di Log di testoNella tabella seguente sono elencate le procedure guidate disponibili per entrambi i file di testo delimitato da virgole e semplice.Oggetto Management PackProcedure guidate disponibilimonitoraggiRilevamento evento semplice utilizzando ognuna dello standard Event Monitor Reset metodiRipetuto il rilevamento di eventi utilizzando ognuna dello standard Event Monitor Reset metodiregoleRegola di generazione avvisiRegola di raccolta eventiOpzioni di creazione guidata Registro di testoQuando si esegue una creazione guidata Registro di testo, è necessario fornire valori per le opzioni nelle tabelle seguenti. Ogni tabella rappresenta una singola pagina della procedura guidata.GeneraleIl Generale pagina include le impostazioni generali per la regola o guidata inclusi il nome, categoria, destinazione e file del management pack in cui salvarlo.OpzioneDescrizioneNomeNome utilizzato per la regola o monitoraggio. Per una regola, viene visualizzato il nome di regole visualizzare nel Authoring riquadro. Quando si crea una vista o un report, è possibile selezionare il nome da utilizzare i dati raccolti da esso. Per un monitoraggio, il nome viene visualizzato in Esplora stati degli oggetti di destinazione.DescrizioneDescrizione facoltativa della regola o del monitoraggio.Management PackManagement pack per archiviare la regola.Per ulteriori informazioni sui management pack, vedere Selecting a Management Pack.Categoria della regola (solo regole)Categoria per la regola. Per una regola di raccolta deve essere la raccolta degli eventi. Per una regola di avviso, deve essere avviso.Monitoraggio padre (solo monitor)Monitoraggio aggregato che verrà posizionato il monitoraggio in Esplora stati. Per ulteriori informazioni, vedere Aggregate Monitors. DestinazioneLa classe da utilizzare per la destinazione della regola o del monitoraggio. La regola o il monitoraggio deve essere eseguito su qualsiasi agente che ha almeno un'istanza di questa classe. Per ulteriori informazioni sulle destinazioni, vedere Targets, Groups, and Objects.La regola è attivataIl monitoraggio è attivatoSpecifica se la regola o il monitoraggio è abilitato.Origine dati del registro applicazioneSarà presente una pagina di origine di applicazione singolo registro dati per una raccolta o regola di avviso e di un monitoraggio dell'utilizzo di reimpostazione manuale o timer. Per un monitoraggio utilizzando la reimpostazione evento, è necessario definire il log per la condizione di errore e per la condizione integra. In genere si specificherà il registro stesso per entrambe le condizioni, ma un altro log può essere utilizzato per ogni.Nella tabella seguente sono elencate le impostazioni che devono essere fornite per un'origine dati del Registro applicazione:Nome proprietà:DescrizioneDirectoryDirectory in cui si trova il file di log. Deve trattarsi di una singola directory con caratteri jolly non utilizzatiCriterioNome del file di log. Se il nome del file di log verrà modificato può includere i caratteri jolly. Utilizzare il? carattere jolly per rappresentare un singolo carattere. Utilizzo di * per rappresentare più caratteri jolly.Separatore (solo per il log delimitato da virgole)Il carattere utilizzato per separare il UTF8Espressione eventoSarà presente una pagina singola espressione per una raccolta o regola di avviso e di un monitoraggio dell'utilizzo di reimpostazione manuale o timer. Per un monitoraggio utilizzando la reimpostazione evento, è necessario definire un'espressione per la condizione di errore e per la condizione integra.L'espressione per una regola di log di testo o un monitoraggio includerà criteri che corrisponde a un testo nella voce del registro. Per un registro di testo generico sono inclusi una ricerca della voce di log intero trattata come una singola riga. Per un file di registro delimitati, questo includerà una ricerca di uno o più dei campi inclusi. Il contenuto di un registro di testo è inclusi i parametri dell'evento. Per un registro di testo generico, si fa riferimento il parametro Params/Param[1]. Un registro delimitato utilizza la stessa variabile utilizzando il numero di indice del parametro obbligatorio. Il primo campo verrà fatto riferimento con Params/Param[1], verrà fatto riferimento con il secondo campo Params/Param[2], e così via.Nella tabella seguente sono elencate le proprietà comuni disponibili testo log monitoraggi e regole:Nome proprietà:DescrizioneDirectoryDirectory in cui si trova il file di log.CriterioNome del file di log da cui è stato eseguito l'evento.Param [1]Completare una voce nel Registro di testo generico.Param [#]Parametro specifico in un registro di testo CSV generico. # rappresenta il numero del campo.Per ulteriori informazioni sulle espressioni, vedere Expressions.Riavvio automatico del timerIl Timer di reimpostazione automatica pagina è disponibile solo per timer Reimposta monitoraggi. Consente di impostare il tempo che deve trascorrere dopo aver creato l'avviso prima che l'avviso verrà risolto automaticamente.Configura statoIl Configura stato pagina è disponibile solo per i monitor. Consente di specificare lo stato di integrità che verrà impostato per ogni evento. Per un manuale Reimposta monitor, la reimpostazione manuale condizione sarà integro, ed è possibile specificare se il generato l'evento condizione verrà impostato il monitoraggio un avviso o un critico stato. Per un Timer reimpostato o evento reimpostato, è possibile specificare lo stato impostato da ogni evento. Il primo evento verrà in genere impostato il monitoraggio avviso o critico mentre il secondo evento o il timer verrà impostato il monitoraggio integro.Configura avvisiIl Configura avvisi pagina è disponibile solo per i monitoraggi e le regole di avviso. Vengono descritte le opzioni disponibili in Alerts.Creazione di monitoraggi e regole di registro di testoUtilizzare la procedura seguente per creare un registro di testo nella regola avvisi Operations Manager con i dettagli seguenti:Viene eseguito in tutti gli agenti con un particolare servizio installato.Cerca una virgola delimitato da file di log con il modello di denominazione MyApp*.log nella directory c:\logs.Genera un avviso se la parola "errore" viene visualizzato nel messaggio del registro.Include il messaggio di errore nella descrizione dell'avviso.Il formato di ogni riga del file di testo è il seguente: data, ora, dei messaggiPer creare una regola di avviso del Registro di testo delimitatoSe non si dispone di un Management Pack per l'applicazione monitorata, crearne uno utilizzando il processo descritto in Selecting a Management Pack.Creare una nuova destinazione utilizzando il processo in To create a Windows Service template. È possibile utilizzare qualsiasi servizio installato in un agente di test per questo modello.Nella console operatore, selezionare il Authoring area di lavoro e quindi selezionare regole.Fare doppio clic su regole e selezionare creare una nuova regola.Nel tipo di regola pagina, eseguire le operazioni seguenti:Espandere regole che generano avvisi, espandere basato su eventi, quindi fare clic su del Registro di testo generico CSV (avviso).Selezionare il management pack dal passaggio 1.Fare clic su Avanti.Nella pagina Generale, eseguire le operazioni seguenti:Nel Nome regola digitare errore registro delimitati MyApplication.Nel categoria della regola selezionare avviso.Accanto a destinazione regola fare clic su selezionare e quindi selezionare il nome della destinazione creata nel passaggio 2.Lasciare regola è attivata selezionato.Fare clic su Avanti.Nel origine dati del Registro applicazione pagina, eseguire le operazioni seguenti:Nel Directory digitare c:\logs.Nel modello digitare MyApp*.log.Nel separatore digitare una virgola.Fare clic su Avanti.Nel Crea espressione evento pagina, eseguire le operazioni seguenti:Fare clic su Inserisci.Nel nome del parametro digitare Params/Param [3].Nel operatore selezionare Contains.Nel valore digitare errore.Fare clic su Avanti.Nel Configura avvisi pagina, eseguire le operazioni seguenti:Nel Nome avviso digitare errore trovato MyApplication delimitato da registro testo.Fare clic sul pulsante ellisse sul lato destro del Descrizione avviso casella.Cancellare il testo di valore casella.Selezionare i dati, quindi Params e Param.Sostituire il testo << INT >> con 1.Spostarsi alla fine della riga e premere la barra spaziatrice.Selezionare i dati, quindi Params e Param.Sostituire il testo << INT >> con 2.Spostarsi alla fine della riga e premere INVIO.Selezionare i dati, quindi Params e Param.Sostituire il testo << INT >> con 3.Fare clic su OK.Fare clic su Fine.Event Monitors and Rules Event Monitor Reset Repeating Events Alerts <_caps3a_sxssource locale="en-US">A text log is a text file that an application uses to log event information. In order to use a text log data source in a management pack, each entry in the log must be on a single line. If the log file does not fit this requirement, then a custom script has to be created to read the log.Applications that use log files frequently create a new file each day or when one file reaches a certain size. To support this functionality, monitors and rules specify a Directory and a Pattern for the text logs being monitored. Directory is the path of the directory where the text logs will be located. This must be an absolute path without wildcard characters. A $Target variable could also be used if the path to the log files is stored in a property of the target class. Pattern is the name of the log file including wildcard characters as appropriate.For example, an application might create a log file each day with the date included in the name as in log20100316.txt. A pattern for such a log might be log*.txt which would apply to any log file following the application’s naming scheme.A text log can be defined as either a Generic Text Log or Generic CSV Text Log. CSV refers to Comma Separated Values, although you can specify any character as the delimiter. The two kinds of files are also referred as a Simple Text Log and a Delimited Text Log. With a simple text log, each line is considered a single entry. With a delimited text log, a single character is used to separate different fields of data, and each field can be analyzed separately.Text Log WizardsThe table below lists the wizards that are available for both simple and delimited text files.Management Pack ObjectWizards AvailableMonitorsSimple Event Detection using each of the standard Event Monitor Reset methodsRepeated Event Detection using each of the standard Event Monitor Reset methodsRulesAlert Generating ruleEvent collection ruleText Log Wizard OptionsWhen you run a text log wizard, you will need to provide values for options in the following tables. Each table represents a single page in the wizard.GeneralThe General page includes general settings for the rule or wizard including its name, category, target, and the management pack file to store it in.OptionDescriptionNameThe name used for the rule or monitor. For a rule, the name appears in the Rules view in the Authoring pane. When you create a view or report, you can select this name to use the data collected by it. For a monitor, the name appears in the Health Explorer of any target objects.DescriptionOptional description of the rule or monitor.Management PackManagement pack to store the rule.For more information on management packs, see Selecting a Management Pack.Rule Category (Rules only)The category for the rule. For a collection rule, this should be Event Collection. For an alerting rule, this should be Alert.Parent Monitor (Monitors only)The aggregate monitor that the monitor will be positioned under in the Health Explorer. For more information, see Aggregate Monitors. TargetThe class to use for the target of the rule or monitor. The rule or monitor will be run on any agent that has at least one instance of this class. For more information on targets, see Targets, Groups, and Objects.Rule is enabledMonitor is enabledSpecifies whether the rule or monitor is enabled.Application Log Data SourceThere will be a single application log data source page for a collection or alerting rule and for a monitor using manual or timer reset. For a monitor using event reset, you will have to define the log for both the error condition and for the healthy condition. You will typically specify the same log for both conditions, but a different log could be used for each.The following table lists the settings that must be provided for an application log data source:Property NameDescriptionDirectoryDirectory that the log file is located in. This must be a single directory with no wildcardsPatternName of the log file. This can include wildcards if the name of the log file will change. Use the ? wildcard to represent a single character. Use the * wildcard to represent multiple characters.Separator (Delimited Logs only)The character that is used to separate the UTF8Event ExpressionThere will be a single expression page for a collection or alerting rule and for a monitor using manual or timer reset. For a monitor using event reset, you will have to define an expression for both the error condition and for the healthy condition.The expression for a text log rule or monitor will include criteria that matches text in the log entry. For a Generic Text Log this includes a search of the whole log entry treated as a single line. For a delimited log file, this will include a search of one or more of the included fields. The contents of a text log are included in the parameters of the event. For a generic text log, this is referenced by the parameter Params/Param[1]. A delimited log uses the same variable by using the index number of the required parameter. The first field would be referenced with Params/Param[1], the second field would be referenced with Params/Param[2], and so on.The following table lists the common properties available from text log monitors and rules:Property NameDescriptionDirectoryDirectory that the log file is located in.PatternName of the log file that the event was taken from.Param[1]Complete entry in a generic text log.Param[#]Specific parameter in a generic CSV text log. # represents the number of the field.For more information about expressions, see Expressions.Auto Reset TimerThe Auto Reset Timer page is only available for timer reset monitors. It allows you to set the time that must pass after the alert is created before the alert is automatically resolved.Configure HealthThe Configure Health page is only available for monitors. It allows you to specify the health state that will be set for each of the events. For a manual reset monitor, the Manual Reset condition will be Healthy, and you can specify whether the Event Raised condition will set the monitor to a Warning or a Critical state. For a Timer Reset or an Event Reset, you can specify the health state set by each event. The first event will typically set the monitor to Warning or Critical while the second event or the timer will set the monitor to Healthy.Configure AlertsThe Configure Alerts page is only available for monitors and alerting rules. Its options are explained in Alerts.Creating Text Log Rules and MonitorsUse the following procedure to create a text log alerting rule in Operations Manager with the following details:Runs on all agents with a particular service installed.Looks for a comma delimited log file with the naming pattern MyApp*.log in the c:\logs directory.Generates an alert if the word “error” appears in the log message.Includes the error message in the alert description.The format of each line of the text file is as follows: Date,Time,MessageTo create a delimited text log alert ruleIf you don’t have a management pack for the application that you are monitoring, create one using the process in Selecting a Management Pack.Create a new target using the process in To create a Windows Service template. You can use any service installed on a test agent for this template.In the Operations console, select the Authoring workspace, and then select Rules.Right-click Rules and select Create a new rule.On the Rule Type page, do the following:Expand Alert Generating Rules, expand Event Based, and then click Generic CSV Text Log (Alert).Select the management pack from step 1.Click Next.On the General page, do the following:In the Rule Name box, type MyApplication Delimited Log Error.In the Rule Category box, select Alert.Next to Rule Target click Select and then select the name of the target that you created in step 2.Leave Rule is enabled selected.Click Next.On the Application Log Data Source page, do the following:In the Directory box, type c:\logs.In the Pattern box, type MyApp*.log.In the Separator box, type a COMMA.Click Next.On the Build Event Expression page, do the following:Click Insert.In the Parameter Name box type Params/Param[3].In the Operator box select Contains.In the Value box type error.Click Next.On the Configure Alerts page, do the following:In the Alert name box, type Error found in MyApplication delimited text log..Click the ellipse button to the right side of the Alert description box.Clear the text in the Value box.Select Data, then Params, then Param.Replace the text <<INT>> with 1.Move to the end of the line and press the SPACE bar.Select Data, then Params, then Param.Replace the text <<INT>> with 2.Move to the end of the line and press the ENTER key.Select Data, then Params, then Param.Replace the text <<INT>> with 3.Click OK.Click Finish.Event Monitors and Rules Event Monitor Reset Repeating Events Alerts