Partager via

  • Article

Règles de collecte de script

 

S'applique à: System Center 2012 R2 Operations Manager, System Center 2012 - Operations Manager, System Center 2012 SP1 - Operations Manager

Règles de collecte de script exécutent un script sur une planification et stocker sa sortie en tant que données de performance ou un événement. Dans le cadre de la création de la règle, vous devez spécifier les valeurs du jeu de propriétés à partir du script ou de propriétés de l'objet cible qui sera utilisé pour les différentes propriétés des données d'événement ou de performance en cours de création.

Options

Lorsque vous exécutez l'Assistant de collecte de script, vous devez fournir des valeurs pour les options dans les tableaux suivants. Chaque tableau représente une page de l'Assistant.

Général

Option

Description

Nom de la règle

Le nom utilisé pour la règle. Il apparaît dans les règles afficher dans le Création volet.

Description

Description facultative de la règle.

Pack d'administration

Pack d'administration pour stocker l'analyse.

Pour plus d'informations sur les packs d'administration, consultez Sélection d'un fichier de Pack d'administration.

Catégorie de règle

La catégorie de la règle. Pour une règle de collecte d'événements, cette valeur doit être collecte d'événements. Pour une règle de collecte de performances, cette valeur doit être collecte des performances.

Cible de la règle

La classe à utiliser pour la cible de la règle. La règle sera exécutée sur n'importe quel agent qui a au moins une instance de cette classe. Pour plus d'informations sur les cibles, consultez Explication des classes et des objets.

Schedule

Le planification page définit la planification pour exécuter le script. Le script s'exécute indéfiniment selon cette planification jusqu'à ce que la règle est désactivée ou supprimée ou le pack d'administration est désinstallé.

Option

Description

Exécuter toutes les

Fréquence à laquelle le script doit être exécuté. Cela doit être généralement pas moins de 5 minutes.

Synchroniser à

S'il est activé, le calendrier est synchronisé pour se produire à l'heure spécifiée.

Script

Le Script page contient le corps du script lui-même et ses paramètres. Vous pouvez taper le script directement dans la boîte de dialogue, mais généralement écrire à l'aide d'un autre éditeur de texte et puis copiez le texte du script et collez-le. Cela vous permet d'utiliser un outil d'édition plus fonctionnel et de tester le script sur une ligne de commande avant de l'inclure dans le pack d'administration.

Option

Description

Nom du fichier

Nom du script. Doit avoir soit une extension .vbs ou .js selon son langage. Il n'est pas nécessaire de rendre ce nom unique, car chaque script se voit attribuer son propre répertoire temporaire sur l'agent.

Expiration du délai

Le nombre de secondes pendant lesquelles le script peut être exécutée avant l'agent l'arrête. Cela empêche des scripts problématiques de s'exécuter en continu et de mettre une surcharge excessive sur l'ordinateur agent.

Le délai d'expiration affecté à un script doit laisser suffisamment de temps au script pour qu'il s'exécute dans des conditions normales, mais il doit être inférieur à l'intervalle planifié pour l'exécution du script. Si un script est configuré pour avoir une valeur de délai d'expiration supérieure à sa durée, puis éventuellement plusieurs copies du script puissent s'exécuter simultanément.

Script

Le corps du script.

Paramètres

Cliquez pour fournir des valeurs pour tous les arguments dans le script. Pour plus d’informations, voir Arguments de script.

Mappeur de performances (collecte des performances uniquement)

Le Mappeur de performances page permet de définir des valeurs pour les propriétés des données de performance sont collectées.

Option

Description

Objet

Texte pour le nom d'objet. Cela est nécessaire.

Compteur

Texte pour le nom du compteur. Cela est nécessaire.

Instance

Texte pour le nom d'Instance. Cela est uniquement requis si la cible de la règle a plusieurs instances.

Valeur

Numérique pour la valeur pour les performances

Mappeur d'événement (collecte d'événements uniquement)

Le Mappeur d'événement page permet de définir des valeurs pour les propriétés de l'événement qui sera collecté. La valeur de chaque champ sera une chaîne de texte, une valeur à partir de l'ensemble des propriétés du script ou la valeur d'une propriété de l'objet cible explicite.

Option

Description

Ordinateur

Le nom de l'événement a été enregistré sur l'ordinateur. Il s'agit généralement d'une variable $Target pour le nom Principal de l'ordinateur. Vous pouvez sélectionner cette valeur en cliquant sur le bouton de sélection en regard de la zone de texte.

Source d'événement

La source de l'événement. Cela est généralement une valeur explicite mais peut être une variable $Data pour utiliser la valeur d'une propriété à partir du script.

Journal des événements

Nom du journal des événements. Cela peut aura une valeur explicite ou une variable $Data pour utiliser la valeur d'une propriété à partir du script.

ID de l'événement

Le nombre d'événements numérique. Ce sera généralement une valeur explicite ou une variable $Data pour utiliser la valeur d'une propriété à partir du script.

Catégorie

La valeur du paramètre EventCategory (un entier compris entre 0 et 65535) est un index dans une table de messages de la bibliothèque de liens dynamiques (DLL) de catégorie qui contient une chaîne localisée. Chaque éditeur définit son propre ensemble de catégories. Ces catégories correspondent généralement aux composants individuels (par exemple : un connecteur, un hôte de module ou un entrepôt de données).

Niveau

La gravité de l'événement. Vous pouvez sélectionner cette valeur dans la liste déroulante.

Création de règles de collecte de Script

La procédure suivante crée une règle de collecte de performances script avec les détails suivants :

  • S'exécute sur n'importe quel ordinateur avec une instance d'un service particulier est installé.

  • Le script accepte deux paramètres, un nom d'ordinateur et un autre pour la version de l'application qui est stockée en tant que propriété sur la classe cible.

  • Le script lui-même est uniquement destinée aux tests et n'exécute aucune fonction réelle. Il simule un script qui exécute une transaction synthétique et en retournant un jeu de propriétés avec des valeurs statiques.

Pour créer un script en fonction la règle de collecte des performances

  1. Si vous ne disposez pas de pack d'administration pour l'application que vous analysez, créez-en un à l'aide du processus dans Sélection d'un fichier de Pack d'administration.

  2. Créer une cible à l'aide du processus dans Pour créer un modèle de Service Windows. Vous pouvez utiliser n'importe quel service installé sur un agent de test pour ce modèle.

  3. Dans la console Opérateur, sélectionnez le Création espace de travail, puis sélectionnez règles.

  4. Avec le bouton droit règles et sélectionnez créer une nouvelle règle.

  5. Sur le Type de règle page, procédez comme suit :

    1. Développez les règles de collecte, puis développez basées sur l'analyse, puis sélectionnez Script (performances).

    2. Dans le Pack d'administration liste déroulante, sélectionnez le pack d'administration de l'étape 1.

    3. Cliquez sur Suivant.

  6. Dans la page Général, procédez comme suit :

    1. Dans le nom de la règle tapez My Application Collect Script Performance.

    2. Dans le catégorie de règle liste déroulante, sélectionnez Performance Collection.

    3. Cliquez sur Sélectionnez.

    4. Sélectionnez le nom de la cible que vous avez créé à l'étape 2.

    5. Cliquez sur OK.

  7. Sur le planification page, procédez comme suit :

    1. Dans le exécuter chaque tapez 15 minutes.

    2. Cliquez sur Suivant.

  8. Dans la page Script, procédez comme suit :

    1. Pour le nom de fichier valeur, tapez MyPerfCollectionScript.vbs

    2. Pour le Timeout valeur, tapez 1 minutes

    3. Dans le Script zone, collez le contenu complet du script suivant.

      sComputerName = WScript.Arguments(0)
sVersion = WScript.Arguments(1)

[oAPI.LogScriptEvent]
Set oAPI = CreateObject("MOM.ScriptAPI")
Set oBag = oAPI.CreatePropertyBag()
Call oBag.AddValue("ComputerName",sComputerName)
Call oBag.AddValue("InstanceName","MyInstance")
Call oBag.AddValue("Value",10)

oAPI.Return(oBag)

    4. Cliquez sur le paramètres bouton.

    5. Sélectionnez cible, sélectionnez (Host = ordinateur Windows), puis sélectionnez PrincipalName (ordinateur Windows).

    6. Tapez un espace.

    7. Sélectionnez cible puis Version (Base de rôle de mon ordinateur).

    8. Cliquez sur OK.

    9. Cliquez sur Suivant.

  9. Sur le Mappeur de performances page, procédez comme suit :

    1. Dans le objet zone MyApplication.

    2. Dans le compteur zone MyCounter.

    3. Dans le Instance zone $Data/Property[@Name=FileName]$.

    4. Dans le valeur zone $Data/Property[@Name=’FileSize’]$.

    5. Cliquez sur Créer.

La procédure suivante crée une règle de collecte script avec les détails suivants :

  • S'exécute sur n'importe quel ordinateur avec une instance d'un service particulier est installé.

  • Le script accepte deux paramètres, un nom d'ordinateur et un autre pour la version de l'application qui est stockée en tant que propriété sur la classe cible.

  • Le script lui-même est uniquement destinée aux tests et n'exécute aucune fonction réelle. Il simule un script qui exécute une transaction synthétique et en retournant un jeu de propriétés avec des valeurs statiques.

Pour créer un script en fonction la règle de collecte des événements

  1. Si vous ne disposez pas de pack d'administration pour l'application que vous analysez, créez-en un à l'aide du processus dans Sélection d'un fichier de Pack d'administration.

  2. Créer une cible à l'aide du processus dans Pour créer un modèle de Service Windows. Vous pouvez utiliser n'importe quel service installé sur un agent de test pour ce modèle.

  3. Dans la console Opérateur, sélectionnez le Création espace de travail, puis sélectionnez règles.

  4. Avec le bouton droit règles et sélectionnez créer une nouvelle règle.

  5. Sur le Type de règle page, procédez comme suit :

    1. Développez les règles de collecte, puis développez basées sur l'analyse, puis sélectionnez Script (événement).

    2. Dans le Pack d'administration liste déroulante, sélectionnez le pack d'administration de l'étape 1.

    3. Cliquez sur Suivant.

  6. Dans la page Général, procédez comme suit :

    1. Dans le nom de la règle tapez My Application Collect Script Event.

    2. Dans le catégorie de règle liste déroulante, sélectionnez Event Collection.

    3. Cliquez sur Sélectionnez.

    4. Sélectionnez le nom de la cible que vous avez créé à l'étape 2.

    5. Cliquez sur OK.

  7. Sur le planification page, procédez comme suit :

    1. Dans le exécuter chaque tapez 15 minutes.

    2. Cliquez sur Suivant.

  8. Dans la page Script, procédez comme suit :

    1. Pour le nom de fichier valeur, tapez MyEventCollectionScript.vbs

    2. Pour le Timeout valeur, tapez 1 minutes

    3. Dans le Script zone, collez le contenu complet du script suivant.

      sComputerName = WScript.Arguments(0)
sVersion = WScript.Arguments(1)

Set oAPI = CreateObject("MOM.ScriptAPI")
Set oBag = oAPI.CreatePropertyBag()
Call oBag.AddValue("ComputerName",sComputerName)
Call oBag.AddValue("EventID",100)
Call oBag.AddValue("ParamValue","Param1")

oAPI.Return(oBag)

    4. Cliquez sur paramètres.

    5. Sélectionnez cible, sélectionnez (Host = ordinateur Windows), puis sélectionnez PrincipalName (ordinateur Windows).

    6. Tapez un espace.

    7. Sélectionnez cible puis Version (Base de rôle de mon ordinateur).

    8. Cliquez sur OK.

    9. Cliquez sur Suivant.

  9. Sur le Mappeur d'événement page, procédez comme suit :

    1. Dans le ordinateur zone $Data/Property[@Name='ComputerName']$.

    2. Dans le source d'événement zone MyApp.

    3. Dans le journal des événements zone CustomScript.

    4. Dans le l'ID d'événement zone $Data/Property[@Name='EventID']$.

    5. Dans le catégorie zone 0.

    6. Dans le niveau boîte Sélectionnez Information.

    7. Cliquez sur le paramètres bouton.

    8. Type $Data/Property[@Name='ParamValue']$

    9. Cliquez sur OK.

    10. Cliquez sur Créer.