La commande PFCmdLineTool permet d'effectuer diverses tâches CA Continuous Application Insight à partir de la ligne de commande.
Les options principales sont --count, --roots, --paths, --export, --import, --baseline et --virtualize.
Cette commande possède le format suivant :
PFCmdLineTool [--count|--roots|--paths|--export|--import|--baseline|--virtualize|--help|--version] [task-specific options] [search-criteria]
Critères de recherche
Pour toutes les options exceptée --import, l'ensemble des trames de transaction utilisées est défini par ceux correspondant aux critères de recherche spécifiés. Utilisez les options suivantes pour spécifier les critères de recherche : --from, --to, --localIP, --remoteIP, --category, --class, --method, --session, --transaction, –agent, --min-time, --tag et --max-frames. Ces options sont utilisées pour réduire l'ensemble de trames de transaction racines sur lesquelles des actions sont effectuées.
De même, vous pouvez utiliser l'option --frame pour limiter les résultats de la recherche à une trame de transaction unique.
Spécifie l'heure de début de la fenêtre de trames de transaction de votre choix. Utilisez l'un des formats suivants : aaaa-mm-jj ou aaaa-mm-jjThh:mm:ss. Si cette option et l'option --frame ne sont pas spécifiées, le début du jour en cours sera utilisé.
Spécifie l'heure de fin de la fenêtre de trames de transaction de votre choix. Utilisez l'un des formats suivants : aaaa-mm-jj ou aaaa-mm-jjThh:mm:ss. Si cette option et l'option --frame ne sont pas spécifiées, la fin du jour en cours sera utilisée.
Spécifie l'adresse IP côté client enregistrée par CAI.
Spécifie l'adresse IP côté client serveur par CAI.
Spécifie le type de trame de transaction. Vous pouvez rechercher plusieurs catégories simultanément en répétant cette option.
Valeurs : amx, client, dn_default, dn_remoting, dn_sql, ejb, gui, jca, jdbc, jms, logging, mq, rest_http, rmi, rmi_http, rmi_ssl, thread, throwable, tibco, web_http, web_https, wm, wps, ws_http, ws_https
Spécifie le nom de la classe. La valeur peut être le nom de la classe complet ou une chaîne terminée par % pour effectuer le type de correspondance starts with (Commence par).
Spécifie le nom de la méthode. La valeur peut être le nom de la méthode complet ou une chaîne terminée par % pour effectuer le type de correspondance starts with (Commence par).
Spécifie l'identificateur de la session.
Spécifie l'identificateur de la transaction.
Spécifie le nom de l'agent qui est la source des trames de transaction que vous recherchez.
Spécifie le délai d'exécution minimum (en millisecondes) des trames de transaction que vous voulez afficher. Les trames exécutées plus rapidement que cette valeur seront filtrées.
Spécifie une balise de trame associée à une trame de transaction. Vous pouvez spécifier le nom uniquement ou le nom et la valeur. Vous pouvez rechercher plusieurs balises simultanément en répétant cette option.
Spécifie le nombre maximum de trames de transaction racines récupérées. Si cette option n'est pas spécifiée, la valeur par défaut sera 10000. Des situations dans lesquelles davantage de trames sont traitées que la valeur maximum peuvent se présenter.
Spécifie l'identificateur de la trame de transaction spécifique de votre choix.
Interrogation et affichage
Les options suivantes permettent d'interroger et d'afficher des transactions.
Affiche le nombre de trames de transaction racines correspondant aux critères de recherche spécifiés.
Affiche les trames de transaction racines correspondant aux critères de recherche spécifiés.
Affiche la hiérarchie des trames de transaction d'un ensemble de trames de transaction racines.
Exportation et Importation
Les options suivantes permettent d'exporter et d'importer des chemins d'accès.
Exporte les trames de transaction sélectionnées à partir de la base de données.
Importe les transactions dans la base de données. Tout critère de recherche spécifié est ignoré.
Spécifie que l'opération d'importation ne conserve pas les données, ce qui entraîne uniquement la validation du fichier d'importation.
Remarque : Lorsque DevTest est connecté à une base de données autre que la base de données Derby par défaut, vous devez spécifier la base de données dans l'élément broker du fichier rules.xml.
<database driver="pilote_BdD" url="URL_BdD" user="serveur_BdD" password="mot_passe_BdD"/>
Ce paramètre sera utilisé pendant la durée de vie de l'agent.
Références
Les options suivantes permettent de créer des suites et des scénarios de test de référence. L'option --to-dir ou l'option --to-project est requise.
Génère des tests de référence pour les trames de transaction sélectionnées.
Spécifie l'identificateur de la trame de transaction spécifique désignée comme trame de transaction clé. Si cette option n'est pas spécifiée, la première trame de transaction dans le résultat de requête sera désignée comme trame de transaction clé.
Indique qu'un scénario de test de référence est généré. Si cette option n'est pas spécifiée, une suite de tests de référence sera générée.
Indique qu'une référence avec état est générée.
Spécifie que les tests de référence sont générés à l'aide de l'étape Execute Transaction Frame (Exécuter la trame de transaction) uniquement. Si cette option n'est pas spécifiée, une étape de test CA Application Test disponible sera utilisée dans la mesure du possible.
Remarque : Pour plus d'informations sur l'étape Execute Transaction Frame (Exécuter la trame de transaction), reportez-vous à la rubrique Utilisation de CA Application Test.
Spécifie que les dates magiques sont traitées au niveau des tests de référence.
Indique la classe de fabriques JNDI à utiliser lors de la génération des tests de référence EJB.
Indique l'URL JNDI à utiliser lors de la génération des tests de référence EJB.
Indique l'utilisateur JNDI à utiliser lors de la génération des tests de référence EJB.
Indique les informations d'identification utilisateur JNDI à utiliser lors de la génération des tests de référence EJB.
Spécifie le nom du répertoire dans lequel le fichier PFI généré est écrit.
Spécifie le répertoire racine d'un projet dans lequel les artefacts générés sont enregistrés sans devoir recourir à un fichier d'importation intermédiaire. Vous pouvez spécifier cette option au lieu de l'option --to-dir, ou en complément de celle-ci.
Artefacts de virtualisation
Les options suivantes permettent de générer des artefacts de virtualisation. L'option --to-dir ou l'option --to-project est requise.
Génère des artefacts de virtualisation pour les trames de transaction sélectionnées.
Spécifie l'identificateur de la trame de transaction spécifique désignée comme trame de transaction clé. Si cette option n'est pas spécifiée, la première trame de transaction dans le résultat de requête sera désignée comme trame de transaction clé.
Spécifie que le traitement conversationnel du VSE est appliqué lors de la génération d'une image de service.
Spécifie l'action effectuée pour les demandes inconnues. Cette option s'applique à des artefacts de virtualisation générés basés sur le VSE Java. Les valeurs valides sont no_match (renvoie une non-correspondance) et no_hijack (omet le service virtuel).
Spécifie le nom du répertoire dans lequel le fichier PFI généré est écrit.
Spécifie le répertoire racine d'un projet dans lequel les artefacts générés sont enregistrés sans devoir recourir à un fichier d'importation intermédiaire. Vous pouvez spécifier cette option au lieu de l'option --to-dir, ou en complément de celle-ci.
Condition d'agent
Les options suivantes permettent de rechercher une condition spécifiée dans un agent. La seule condition prise en charge est si la répartition est en cours pour l'agent. Le terme répartition fait référence à la capture de transactions.
Recherche une condition spécifiée dans un agent.
Spécifie le nom de l'agent.
Spécifie la condition à rechercher.
Valeurs : Dispatching (Répartition)
Spécifie le délai d'attente en secondes avant l'expiration de la condition.
Niveaux de capture
Les options suivantes vous permettent de modifier le niveau de capture pour chaque protocole que l'agent Java peut capturer.
Remarque : La définition de niveaux de capture différents n'est pas prise en charge pour le client de file d'attente et la communication de le serveur ; par exemple, WebSphere MQ et JMS.
Modifie le niveau de capture d'un ou de plusieurs protocoles.
Spécifie le nom de l'agent.
Spécifie les noms de protocole. Si vous incluez plusieurs valeurs, séparez-les par des virgules.
Valeurs : ALL, HTTP Client, HTTP Server, Logging, Category, Exception, GUI, EJB, JMS, MQ, JCA, RCP, RMI, SAP, Tibco, WPS, WebMethods, JDBC
Spécifie les noms de poids. Si vous incluez plusieurs valeurs, séparez-les par des virgules.
Valeurs : 0, 4, 8. La valeur 0 correspond au niveau Counts (Nombres). La valeur 4 correspond au niveau Counts and Paths (Nombres et chemins). La valeur 8 correspond au niveau Full Data (Données complètes).
Divers
Les options suivantes sont également disponibles :
Spécifie la chaîne de connexion de l'intermédiaire. La valeur par défaut est tcp://localhost:2009.
Recherche la trame de transaction qui correspond aux critères de recherche spécifiés et au nom de trame.
Spécifie le nom de la trame de transaction à rechercher.
Affiche le texte d'aide.
Permet d'imprimer le numéro de version.
Exemple : affichage de trames de transaction racines
Cet exemple illustre la procédure permettant d'afficher les trames de transaction racines pour un agent spécifique et l'heure de début.
PFCmdLineTool --roots --agent=JBoss_LISABank --from=2014-03-14T12:28:00 Frame ID Time Category Local IP Remote IP Name Exec Time ------------------------------------ ----------------------- -------- ------------- ------------- ------- --------- c3a9c830-abae-11e3-b937-0024d6ab5ce2 2014-03-14 12:28:04 660 web_http 10.132.92.143 10.132.92.143 Unknown 984 ms
Exemple : affichage d'une hiérarchie de trames de transaction
Cet exemple illustre la procédure permettant d'afficher la hiérarchie de trames de transaction pour un ensemble de trames de transaction racines.
PFCmdLineTool --paths --agent=JBoss_LISABank --from=2014-03-14T12:28:00
984 ms /lisabank/buttonclick.do (c3a9c830-abae-11e3-b937-0024d6ab5ce2)
50 ms $Proxy93.getUser (c3c73b40-abae-11e3-b937-0024d6ab5ce2)
37 ms EJB3UserControlBean.getUser (c3c8c1e0-abae-11e3-b937-0024d6ab5ce2)
3 ms SQL Activity (1) (c3c8c1e0-abae-11e3-b937-0024d6ab5ce2-SQL)
Exemple : génération d'une suite de tests de référence
Cet exemple illustre la procédure de génération d'une suite de tests de référence.
PFCmdLineTool --baseline=BaselineName --refer=c3c8c1e0-abae-11e3-b937-0024d6ab5ce2 --to-dir=C:\DevTest
Exemple : génération d'une référence avec état
Cet exemple illustre la procédure de génération d'une référence avec état.
PFCmdLineTool --baseline=BaselineName --stateful --from=2014-03-14T12:28:00 --refer=c3c8c1e0-abae-11e3-b937-0024d6ab5ce2 --to-dir=C:\DevTest
Exemple : génération d'artefacts de virtualisation
Cet exemple illustre la procédure de génération d'artefacts de virtualisation.
PFCmdLineTool --virtualize=VSEServiceName --from=2014-03-14T12:28:00 --refer=c3c8c1e0-abae-11e3-b937-0024d6ab5ce2 --category=ejb --to-dir=C:\DevTest
Exemple : vérification de la condition d'agent
Cet exemple indique la procédure permettant de vérifier si un agent capture des transactions. La sortie indique que l'agent ne capture pas de transactions.
PFCmdLineTool --check --agent=JBoss_LISABank --condition=Dispatching --check-timeout=10
L'agent n'a pas encore commencé la répartition.
Exemple : configuration du niveau de capture
Cet exemple indique la procédure de modification du niveau de capture pour un protocole.
PFCmdLineTool --set-weights --agent=JBoss_LISABank --protocols=EJB --weights=8
Cet exemple indique la procédure de modification du niveau de capture pour plusieurs protocoles. Remarquez l'utilisation de guillemets.
PFCmdLineTool --set-weights --agent=JBoss_LISABank --protocols="EJB,JMS" --weights="8,4"
Exemple : recherche de trame de transaction par nom
Cet exemple indique la procédure permettant de vérifier si CAI a capturé une trame de transaction par son nom. Si la recherche renvoie plusieurs trames correspondantes, la trame la plus récente est affichée. La sortie comprend le nom, la durée et l'identificateur unique.
PFCmdLineTool --search-frame --frame-name=EJB3AccountControlBean.addAccount --from=2014-03-20T10:20:00
EJB3AccountControlBean.addAccount, 141 ms, 27ca1bd0-b03c-11e3-a8f1-005056ba138a
|
Copyright © 2014 CA Technologies.
Tous droits réservés.
|
|