L'agent de diagnostic de formulaires ou l'agent de mesures de formulaires permet à l'utilisateur d'analyser diverses informations liées aux performances des applications de formulaires exécutées dans votre environnement

Note:Pour que Forms Diagnostics Agent fonctionne, voir Installation et configuration d'Oracle Forms .

Cet agent accède aux données de métriques (disponibles dans DMS) à intervalles réguliers et renseigne les tables de base de données. Ce processus permet à l'utilisateur d'accéder aux données collectées sous forme de données historiques. Le déploiement de l'agent Forms Diagnostics est facultatif. L'application de l'agent fournit une interface interactive où l'utilisateur peut spécifier la fréquence de collecte des données et également contrôler le démarrage et l'arrêt de la collecte des données. Cela peut être réalisé en effectuant les tâches décrites dans les sections suivantes :

• Configuration du schéma de base de données
• Configuration d'une source de données dans WebLogic
• Déploiement de l'agent de diagnostic des formulaires
• Gestion de la collecte de données
• Utiliser l'application Agent
• Limitations de l'application Agent

Configuration du schéma de base de données

Pour configurer le schéma de base de données pour Forms Diagnostics Agent, vous devez créer un utilisateur et un schéma dans la base de données. L'utilisateur peut choisir une instance de base de données de son choix. Aucune base de données spéciale n'est installée avec Forms ou l'agent de diagnostic.

Créer un utilisateur dans la base de données

Note:

Avant de créer un utilisateur dans la base de données, assurez-vous que le nom d'utilisateur que vous avez fourni est nouveau et n'existe pas déjà. En effet, le .sqlscript (utilisé pour créer l'utilisateur dans la base de données) remplace l'utilisateur (nom d'utilisateur fourni lors de la création) par le nouvel utilisateur.

Pour créer un utilisateur dans la base de données, procédez comme suit :

1. Connectez-vous à la base de données comme sysdbaindiqué ci-dessous : sqlplus sys/@ as sysdba
2. Exécutez le script suivant : @ORACLE_HOME/forms/forms_create_diagnostics_user.sql.
3. L'utilisateur doit saisir l'identifiant et le mot de passe.

L'utilisateur est créé dans la base de données.

Créer un schéma dans la base de données

Note:

Avant de créer un schéma dans la base de données, assurez-vous que le nom d'utilisateur que vous avez fourni est nouveau et n'existe pas déjà. En effet, le .sqlscript (utilisé pour créer le schéma dans la base de données) remplace le schéma (nom d'utilisateur fourni lors de la création) par le nouveau schéma.

Pour créer un schéma dans la base de données, procédez comme suit :

1. Connectez-vous à la base de données en tant qu?utilisateur que vous avez créé dans les étapes ci-dessus : sqlplus /@
2. Exécutez le script suivant : @ORACLE_HOME/forms/forms_create_diagnostics_schema.sql

Le schéma est créé dans la base de données.

Configuration d'une source de données dans WebLogic

Après avoir configuré la base de données pour qu'elle fonctionne avec l'agent de diagnostic des formulaires, vous devez configurer une source de données à l'aide de la console Weblogic.

Pour configurer une source de données à l?aide de la console Weblogic, procédez comme suit :

1. Connectez-vous à la console WebLogic.
2. Dans le panneau de navigation de gauche, sélectionnez Services et accédez à Sources de données . Cliquez sur Verrouiller et modifier dans la fenêtre Centre de modifications pour apporter des modifications.
3. Dans la page Résumé des sources de données JDBC , cliquez sur Configuration . Dans le tableau Sources de données , cliquez sur Nouveau et sélectionnez Sources de données génériques dans la liste.
4. Saisissez les valeurs pour les paramètres suivants : nom des sources de données JDBC L'utilisateur peut saisir n'importe quel nom. Nom JNDI oracle/formulaires/agentDS Type de base de données Choisissez le type de base de données que vous avez utilisé pour créer l?utilisateur et le schéma dans les étapes précédentes. Cliquez sur Suivant . La page Créer une nouvelle source de données JDBC s'affiche.
5. Sélectionnez Pilote de base de données dans la liste des pilotes disponibles pour le type de base de données que vous avez sélectionné. Cliquez sur Suivant .
6. Saisissez les valeurs pour les paramètres suivants : Nom de la base de données Nom de l'hôte Port Nom d'utilisateur de la base de données Saisissez le nom d?utilisateur que vous avez utilisé lors de la création d?un utilisateur dans la base de données dans les étapes ci-dessus. Mot de passe Saisissez le mot de passe que vous avez utilisé lors de la création d?un utilisateur dans la base de données dans les étapes ci-dessus. Cliquez sur Suivant .
7. Sur la page suivante, cliquez sur Configurations de test dans le coin supérieur gauche pour vérifier si la base de données a été configurée avec succès. Cliquez sur Suivant .
8. Sélectionnez Admin Server comme cible pour déployer la source de données. Cliquez sur Terminer .
9. Cliquez sur Activer les modifications dans la fenêtre Centre des modifications pour enregistrer les modifications.

Vous avez maintenant configuré une source de données JDBC.

Déploiement de l'agent de diagnostic des formulaires

Après avoir configuré une source de données dans Weblogic, l'agent Forms Diagnostics doit être déployé sur le serveur d'administration Weblogic.

Pour déployer l'agent Forms Diagnostics, procédez comme suit dans la console Weblogic :

1. Connectez-vous à la console Weblogic.
2. Dans le panneau de navigation de gauche, sélectionnez Déploiements . Cliquez sur Verrouiller et modifier dans la fenêtre Centre de modifications pour apporter des modifications.
3. Dans la page Résumé des déploiements, cliquez sur Installer . La page Assistant d?installation d?application s?affiche.
4. Entrez le chemin du fichier .war comme indiqué ci-dessous : ORACLE_HOME/forms/j2ee C'est l'emplacement du formsagentapp.warfichier.
5. Sélectionnez le formsagentapp.warfichier. Cliquez sur Suivant . La page Choisir le style de ciblage s?affiche.
6. Sélectionnez Installer ce déploiement en tant qu?application .
7. Sélectionnez Admin Server comme cible pour déployer Forms Diagnostics Agent. Cliquez sur Suivant .
8. Laissez les paramètres facultatifs à leurs valeurs par défaut et cliquez sur Terminer . Cliquez sur Activer les modifications dans la fenêtre Centre des modifications pour enregistrer les modifications.

L'agent Forms Diagnostics a été déployé avec succès sur le serveur d'administration Weblogic.

Pour démarrer l'application, sélectionnez formsagentapp dans la liste des applications déployées et cliquez sur Démarrer .

Gestion de la collecte de données

L'agent Forms Diagnostics permet aux utilisateurs de gérer la collecte de données à l'aide d'une interface.

L'utilisateur peut spécifier la fréquence de collecte des données et contrôler le démarrage ou l'arrêt de la collecte des données. Pour ce faire, il peut procéder comme suit :

1. Connectez-vous à la console de l'agent en utilisant l'URL suivante : http://:/formsagent/AgentConsole.jsp
2. Entrez l'identifiant utilisateur et le mot de passe. Tout utilisateur disposant de privilèges d?administrateur peut se connecter à la console.
3. Saisissez une valeur pour la fréquence de collecte des données . Ce paramètre correspond à la différence de temps entre deux collectes de données consécutives. La valeur par défaut est de 10 minutes. La valeur minimale doit être d'une minute.
4. Cliquez sur Démarrer .

Un message s'affiche indiquant que l'agent de diagnostic des formulaires est en cours d'exécution. Cliquez sur Arrêter chaque fois que vous souhaitez arrêter la collecte des mesures par l'agent.

Utiliser l'application Agent

Lorsque l'utilisateur demande à l'application agent de démarrer la collecte des mesures, l'agent collecte les mesures à partir de DMS et remplit les tables de base de données. L'utilisateur peut accéder à ces mesures collectées dans les tables de base de données.

Pour utiliser ces mesures collectées, l'utilisateur peut créer une application frontale qui sera capable de lire ces données et d'analyser les performances historiques des applications Forms exécutées dans votre environnement en préparant des graphiques, des diagrammes, etc.

La clé primaire et la clé étrangère de chaque table ont été mentionnées dans les tables respectives. Voici les tables de base de données qui sont renseignées lors de la collecte des métriques par l'agent Forms Diagnostics :

Tableau -47 Table de base de données ADMIN_SERVER

Numéro de série	Nom de la colonne	Valeur de l'échantillon	Description
01	ID_AGENT	1	AGENT_ID est la clé primaire dans la table de base de données ADMIN_SERVER. ID de l'application de l'agent. Toute valeur entière commençant par 1
02	ADMIN_HOSTNAME	monhebergeur.mondomaine.com	Nom de la machine sur laquelle le serveur d'administration est déployé
03	PORT_ADMINISTRATIF	7001	Port du serveur d'administration

Tableau -48 Tableau de base de données AGENT

Numéro de série	Nom de la colonne	Valeur de l'échantillon	Description
01	STATUT_AGENT	En cours d'exécution	Statut de l'agent
02	TEMPS RÉEL	23/07/2009 à 17:11:41	Date et heure d'enregistrement du statut Toutes les entrées horaires sont en UTC/GMT
03	ID_SÉQUENCE	205	ID créé par l'agent à chaque fois que le statut de l'agent est enregistré
04	FRÉQUENCE	40	Différence de temps (en minutes) entre deux collectes de données consécutives
05	ID_AGENT	1	AGENT_ID est une clé étrangère dans cette table de base de données. Elle fait référence à AGENT_ID dans la table de base de données ADMIN_SERVER ID de l'application de l'agent. Toute valeur entière commençant par 1

Tableau -49 Table de base de données FRM_DB

Numéro de série	Nom de la colonne	Valeur de l'échantillon	Description
01	ID_DB_FRM	8769	FRM_DB_ID est la clé primaire dans la table de base de données FRM_DB. ID attribué à la base de données utilisée par l'application Forms
02	NOM_DB	v11g	La base de données à laquelle frmweb est connecté. S'il est connecté à v11g, ce champ affichera v11g. Cela peut être NULL lorsque frmweb n'est connecté à aucune base de données
03	ENTRÉE_TNS	(DESCRIPTION = (LISTE_D'ADRESSES = (ADRESSE = (PROTOCOLE = TCP)(HÔTE = sample.host.com)(PORT = 1521))) (CONNECT_DATA = (SERVICE_NAME = v11g)))	Entrée TNS de la base de données à laquelle frmweb est connecté
04	NOM D'UTILISATEUR	Scott	L'utilisateur de la base de données qui s'est connecté

Tableau -50 FRM_DB_LOGIN Table de base de données

Numéro de série	Nom de la colonne	Valeur de l'échantillon	Description
01	ID_CONNEXION_DB_FRM	345	FRM_DB_LOGIN_ID est la clé primaire dans la table de base de données FRM_DB_LOGIN. ID attribué à chaque ligne du tableau
02	ID_DURÉE_D'EXÉCUTION_FRM	107	FRM_RUNTIME_ID est une clé étrangère dans cette table de base de données. Elle fait référence à FRM_RUNTIME_ID dans la table de base de données FRM_RUNTIME
03	ID_DB_FRM	1025	FRM_DB_ID est une clé étrangère dans cette table de base de données. Elle fait référence à FRM_DB_ID dans la table de base de données FRM_DB ID attribué à la base de données utilisée par l'application Forms
04	TEMPS RÉEL	23/07/2009 à 17:11:41	Date et heure d'enregistrement du statut et données métriques collectées pour mettre à jour le tableau Toutes les entrées horaires sont en UTC/GMT

Tableau -51 Table de base de données FRM_RUNTIME

Numéro de série	Nom de la colonne	Valeur de l'échantillon	Description
01	ID_DURÉE_D'EXÉCUTION_FRM	107	FRM_RUNTIME_ID est une clé primaire dans la table de base de données FRM_RUNTIME. ID qui identifie le processus de formulaires
02	ID_APPLICATION_WLS	5005	WLS_APP_ID est une clé étrangère dans cette table de base de données. Elle fait référence à WLS_APP_ID dans la table de base de données WLS_APP Détermine l'application Forms dans la table WLS_APP
03	ID_UTILISATEUR_FRM	1310	FRM_USER_ID est une clé étrangère dans cette table de base de données. Elle fait référence à FRM_USER_ID dans la table de base de données FRM_USER ID attribué au client Forms ou à l'instance client
04	VALEUR_CONFIG		Nom de la section de configuration deformsweb.cfg
05	TEMPS DE CONNEXION	23/07/2009 à 17:11:41	Date et heure de création de frmweb Toutes les entrées horaires sont en UTC/GMT
06	HEURE DE DÉCONNECTION	23/07/2009 à 18:15:43	Date et heure de fin de frmweb Toutes les entrées horaires sont en UTC/GMT
07	NOM_FORMULAIRE_DE_DEPART	emp	Nom de la forme de départ
08	ID_PROCESSUS	8020	ID de processus de frmweb sur la machine de niveau intermédiaire
09	FRM_STATUT	En cours d'exécution / Sortie	Statut de frmweb
10	FRM_CPU_TIME_ON_EXIT	256	Temps CPU à la sortie de frmweb
11	FRM_MEMOIRE_PRIVEE_A_LA_SORTIE	6385	Mémoire utilisée par le processus Forms au moment de la sortie
12	FRM_CODE_SORTIE

Tableau -52 Tableau de base de données FRM_TRACE

Numéro de série	Nom de la colonne	Valeur de l'échantillon	Description
01	ID_TRACE_FRM	2679	FRM_TRACE_ID est la clé primaire de cette table de base de données. ID attribué aux lignes de la table de base de données FRM_TRACE
02	FICHIER_TRACE	formulaires_1055.trc	Nom du fichier de trace lorsque cette ftraceoption est activée. Il peut être NULL si ftracecette option est désactivée.
03	TRACÉ	matrace	Le nom du groupe de traces sélectionné par l'application

Tableau -53 Table de base de données FRM_TRACE_USE

Numéro de série	Nom de la colonne	Valeur de l'échantillon	Description
01	ID_UTILISATION_TRACE_FRM	1906	FRM_TRACE_USE_ID est la clé primaire de cette table de base de données. ID attribué aux lignes de la table de base de données
02	ID_DURÉE_D'EXÉCUTION_FRM	107	FRM_RUNTIME_ID est une clé étrangère dans cette table de base de données. Elle fait référence à FRM_RUNTIME_ID dans la table de base de données FRM_RUNTIME ID qui identifie le processus de formulaires
03	ID_TRACE_FRM	2679	FRM_TRACE_ID est une clé étrangère dans cette table de base de données. Elle fait référence à FRM_TRACE_ID dans la table de base de données FRM_TRACE ID attribué à la ligne dans la table de base de données
04	TEMPS RÉEL	23/07/2009 à 17:11:41	Date et heure d'enregistrement du statut et données métriques collectées pour mettre à jour le tableau Toutes les entrées horaires sont en UTC/GMT

Tableau -54 FRM_USER Table de base de données

Numéro de série	Nom de la colonne	Valeur de l'échantillon	Description
01	ID_UTILISATEUR_FRM	1310	FRM_USER_ID est la clé primaire de cette table de base de données. ID attribué au client Forms ou à l'instance client
02	CLIENT_IP	255.255.255.255	Adresse IP de la machine cliente à partir de laquelle le navigateur a été lancé et via laquelle l'utilisateur s'est connecté au niveau intermédiaire
03	ID_UTILISATEUR_SSO	nomf.noml@myapp.com	ID de connexion unique de l'utilisateur qui s'est connecté.

Tableau -55 Tableau de base de données HISTORY

Numéro de série	Nom de la colonne	Valeur de l'échantillon	Description
01	ID_DURÉE_D'EXÉCUTION_FRM	107	FRM_RUNTIME_ID est une clé étrangère dans cette table de base de données. Elle fait référence à FRM_RUNTIME_ID dans la table de base de données FRM_RUNTIME ID qui identifie le processus de formulaires
02	TEMPS RÉEL	23/07/2009 à 17:11:41	Date et heure de prise de l'instantané Toutes les entrées horaires sont en UTC/GMT
03	ID_SÉQUENCE	205	ID créé par l'agent à chaque fois que le statut de l'agent est enregistré.
04	FRM_BYTES_ENVOYÉS	400	Nombre d'octets envoyés du serveur au client pour ce processus jusqu'à présent
05	FRM_BYTES_ENVOYÉS_DELTA	37	Différence dans le nombre d'octets envoyés du serveur au client pour ce processus depuis la dernière lecture de l'agent
06	FRM_BYTES_REÇUS	200	Nombre d'octets envoyés du client au serveur pour ce processus jusqu'à présent
07	FRM_OCTETS_REÇUS_DELTA	23	Différence dans le nombre d'octets envoyés du client au serveur pour ce processus depuis la dernière lecture de l'agent
08	FRM_RÉSEAU_ALLER_RETOUR	30	Nombre d'allers-retours réseau entre le client et le serveur pour ce processus jusqu'à présent
09	DELTA_ALLER_RETOUR_RESEAU_FRM	3	Différence dans le nombre d'allers-retours réseau entre le client et le serveur pour ce processus depuis la dernière lecture de l'agent
10	FRM_CPU_TIME	230	Temps de traitement total pris par frmweb (en millisecondes) pour ce processus jusqu'à présent
11	DELTA_TEMPS_CPU_FRM	47	Différence dans la valeur de FRM_CPU_TIME depuis la dernière lecture de l'agent
12	FRM_MÉMOIRE_PRIVÉE	7998	Mémoire utilisée par le processus Formulaires au moment où l'instantané a été pris.
13	ITÉRATION	50	Nombre de fois que les données sont collectées dans la table de base de données.

Tableau -56 Table de base de données WLS_APP

Numéro de série	Nom de la colonne	Valeur de l'échantillon	Description
01	ID_APPLICATION_WLS	5005	WLS_APP_ID est la clé primaire de cette table de base de données. Détermine l'application Forms dans la table WLS_APP
02	TYPE_SERVEUR	GÉRÉ	Type de serveur (par exemple, MANAGED ou ADMIN)
03	NOM_SERVEUR	WLS_FORMULAIRES	Nom du serveur
04	NOM_APPLICATION_DÉPLOYÉE	formulairesapp	Formulaires Nom de l'application
05	FORMULAIRES_NOM D'HÔTE	host52.exemple.com	Machine de niveau intermédiaire sur laquelle l'environnement d'exécution de Forms est exécuté
06	NOM_D'INSTANCE_HOME	asinst_1	Nom de l'instance d'accueil FMW, où l'exécution de Forms est déployée
07	NOM_CLUSTER	cluster_xyz	Nom du cluster où l'application Forms est déployée
08	ID_AGENT	1	AGENT_ID est une clé étrangère dans cette table de base de données. Elle fait référence à AGENT_ID dans la table de base de données ADMIN_SERVER. ID de l'application de l'agent. Toute valeur entière commençant par 1

Limitations de l'application Agent

L'agent Forms Diagnostics présente certaines limitations quant à son déploiement et son utilisation.

Les limitations sont les suivantes :

• Le déploiement de l'application Forms Diagnostics Agent est facultatif. Si vous souhaitez analyser les informations relatives aux performances des applications Forms, vous devez déployer l'agent Forms Diagnostics manuellement après l'installation.
• L'application agent doit être déployée uniquement sur le serveur d'administration. L'application agent collecte des informations sur toutes les sessions Forms exécutées dans le domaine WLS du serveur d'administration.
• Pour que l'agent puisse accéder aux données de métriques (disponibles dans DMS), l'application DMS doit être opérationnelle.
• Le schéma est conçu pour être fonctionnel uniquement sur un domaine à la fois. Vous ne pouvez pas utiliser le même schéma pour plusieurs agents (exécutés dans des domaines distincts).
• Ne définissez pas la fréquence de collecte des données sur une valeur trop faible. La définition d'une fréquence de collecte des données trop faible ralentit l'environnement de production et entraîne une collecte de données excessive et inutile.
• Cet utilitaire fournit uniquement les objets de base de données et l'agent nécessaires pour effectuer la collecte. Il ne fournit pas d'interface utilisateur (UI) pour exposer les données collectées. Les données peuvent être récupérées en interrogeant les tables décrites dans la documentation ci-dessus. Alternativement, une interface utilisateur peut être développée à l'aide d'une technologie préférée.