Chat now with support

Get Live Help
Complete Registration

Sign In

Request Pricing

Contact Sales

FREE TRIALS

Foglight for PeopleSoft 5.6.11 - User and Reference Guide

Table of Contents

Using Foglight for PeopleSoft

Exploring the PeopleSoft Dashboards

Deploying a Dashboard

Foglight for PeopleSoft Agents PS_AppMonitor Agent

Setting the PS_AppMonitor Connection Details Setting the PS_AppMonitor Data Management Parameters Setting the PS_AppMonitor Domain Information

PS_AppServer Agent

PS_AppServer Agent Properties Setting the PS_AppServer Connection Details Setting the PS_AppServer Data Management Parameters Setting the PS_AppServer PeopleSoft Parameters Investigating Domain Performance Investigating Domain Utilization

PS_DB2SQL Agent

PS_DB2SQL Agent Properties Setting the PS_DB2SQL Connection Details Setting the PS_DB2SQL Data Management Parameters Investigating Database Usage and PeopleSoft User Intensive SQL Statements

PS_MSSQL Agent Properties Setting the PS_MSSQL Connection Details Setting the PS_MSSQL Data Management Parameters Setting the PS_MSSQL Server Filter Parameters Investigating Database Usage and PeopleSoft User Intensive SQL Statements

PS_OracleSQL Agent

PS_OracleSQL Agent Properties Setting the PS_OracleSQL Connection Details Setting the PS_OracleSQL Data Management Parameters Setting the PS_OracleSQL Server Database Parameters Investigating Database Usage and PeopleSoft User Intensive SQL Statements

PS_PPM Agent Properties Setting the PS_PPM Connection Parameters Setting the PS_PPM Data Management Parameters Setting PS_PPM Threshold Parameters Investigating PeopleSoft Enterprise Performance Investigating PeopleSoft Web Server Performance Investigating PeopleSoft Application Server Performance

PS_SchedMonitor Agent

PS_SchedMonitor Agent Properties Setting the PS_SchedMonitor Connection Details Setting the PS_SchedMonitor Data Management Parameters Setting the PS_SchedMonitor Deployment Configuration Parameters

PS_SchedServer Agent

PS_SchedServer Agent Properties Setting the PS_SchedServer Connection Details Setting the PS_SchedServer Data Management Properties Setting the PS_SchedServer PeopleSoft Parameters Investigating Domain Performance Investigating Domain Utilization

PS_Scheduler Agent

PS_Scheduler Agent Properties Setting the PS_Scheduler Connection Details Setting the PS_Scheduler Data Management Properties Setting the PS_Scheduler Job and Process Collection Properties Setting the PS_Scheduler Oracle Database Properties Setting the PS_Scheduler DB2 UDB Database Properties Setting the PS_Scheduler MSSQL Database Properties Investigating Scheduler Status, Job and Process Details

Manual Agent Naming Deployment Scenario Procedures

Foglight for PeopleSoft Reference

PS_AppServer Views

PS_AppServer_Domain_Overview Graph View PS_AppServer_Domain_Utilization_Overview Graph View PS_AppServer_Process_Utilization_Overview Graph View PS_AppServer_Active_Clients Table View PS_AppServer_Active_Services Graph View PS_AppServer_Domain_Config Table View PS_AppServer_Domain_Totals Table View PS_AppServer_Process_Configuration Graph View PS_AppServer_Process_Details Table View PS_AppServer_Process_Totals Table View PS_AppServer_Queue_Summary Graph View PS_AppServer_Services Table View PS_AppServer_Users_In_Queue Graph View

PS_DB2SQL Views

PS_DB2SQL_PID_Overview Graph View PS_DB2SQL_PID_Detail Table View

PS_MSSQL_PID_Overview Graph View PS_MSSQL_PID_Detail Table View

PS_OracleSQL Views

PS_Ora_PID_Overview Graph View PS_Ora_PID_Detail Table View

PPM_App_Server_Overview Graph View PPM_Enterprise_Performance_Overview Graph View PPM_Web_Server_Overview Graph View PPM_App_Server_Detail Table View PPM_App_Server_Load_Distribution Graph View PPM_Enterprise_Details Table View PPM_Enterprise_Duration_Service_Level Graph View PPM_Enterprise_Duration_Time_Details Table View PPM_Enterprise_Duration_Time_Distribution Graph View PPM_Enterprise_Tier_Duration_Time Graph View PPM_Long_PMU_Detail Table View PPM_Web_Server_Detail Table View PPM_Web_Server_Load_Distribution Graph View

PS_SchedServer Views

PS_SchedServer_Domain_Overview Graph View PS_SchedServer_Domain_Utilization_Overview Graph View PS_SchedServer_Process_Utilization_Overview Graph View PS_SchedServer_Domain_Totals Table View PS_SchedServer_Process_Configuration Graph View PS_SchedServer_Process_Details Table View PS_SchedServer_Process_Totals Table View PS_SchedServer_Queue_Summary Graph View

PS_Scheduler Views

PSS_Current_JobNumbers Graph View PSS_Current_Jobs Graph View PSS_Current_Processes Graph View PSS_Current_Users Graph View PSS_DB_Overview Graph View PSS_Jobs_ProcessingTime Table View PSS_JobSummary Graph View PSS_Prcs_Types Graph View PSS_Processes_Hold_List Table View PSS_Processes_ProcessingTime Table View PSS_Processes_QueuedList Table View PSS_ProcessList Table View PSS_ProcessSummary Graph View PSS_Queue_Overview Graph View PSS_RptDist_Overview Graph View PSS_RptDistPrcs_List Table View PSS_RptDistPrcs_Summary Graph View PSS_Server_Uptime Graph View

PS_AppMonitor Agent Data Table

PS_AppMonitor AgentMsgs Data Table

PS_AppServer Agent Data Tables

PS_AppServer AgentMsgs Data Table AppServer_Process_Details Data Table Clients Data Table DomainConfiguration Data Table DomainTotals Data Table LogMessages Data Table Queue_Process_Totals Data Table Services Data Table

PS_DB2SQL Agent Data Tables

PS_DB2SQL AgentMsgs Data Table PS_DB2SQL UserData Data Table

PS_MSSQL Agent Data Tables

PS_MSSQL AgentMsgs Data Table PS_MSSQL UserData Data Table

PS_OracleSQL Agent Data Tables

PS_OracleSQL AgentMsgs Data Table PS_OracleSQL UserData Data Table

PS_PPM Agent Data Tables

PS_PPM PPMAgentMsgs Data Table PPMPeoplesoftAppServerSummary Data Table PPMPeoplesoftEnterpriseSummary Data Table PPMPeoplesoftLongPMUs Data Table PPMPeoplesoftWebServerSummary Data Table

PS_SchedMonitor Agent Data Table

PS_SchedMonitor AgentMsgs Data Table

PS_SchedServer Agent Data Tables

PS_SchedServer AgentMsgs Data Table SchedServer_Domain_Totals Data Table SchedServer_LogMessages Data Table SchedServer_Queue_Process_Details Data Table SchedServer_Queue_Process_Totals Data Table

PS_Scheduler Agent Tables

PS_Scheduler AgentMsgs Data Table PrcsTypeSummary Data Table QueueJobs Data Table QueueJobSummary Data Table QueuePrcs Data Table QueuePrcsSummary Data Table ReportDistributionAgent Data Table ReportDistributionPrcs Data Table ReportDistributionPrcsSummary Data Table RunPrcs Data Table SchedConfig Data Table SchedProcess Data Table

PS_AppMonitor AgentMsgs Data Table

The AgentMsgs (Agent Messages) Table logs information about the PS_AppMonitor agent.


Field	Description
Message	The text provided by the agent describing the error condition. It displays in the agent error rule.
MessageID	The unique agent message ID. Each error starts with an agent prefix followed by a three-digit number, for example, PS_AppMonitor_001, PS_AppMonitor_002, and so on. Refer to the following tables for the PeopleSoft agent message numbers and descriptions.
Severity	Severity of the agent error condition, for example, Informational, Warning, Critical, Fatal.
MsgCnt	Number of identical messages for the current collection cycle—helps to avoid message storms.

The following are the PS_AppMonitor agent error messages:


Message ID	Severity	Message Text	User Action
PS_AMON_301	Warning	The Domains List Name that is being used is invalid. Edit your agent properties and create a new list named as follows: <AgentName><HostName>	Edit agent properties and use the recommended value as the domain list name.
PS_AMON_302	Warning	No Domains where found under PeopleSoft Home directory. Verify agent properties information.	Verify that the PeopleSoft Home Directory is an active enterprise.
PS_AMON_303	Warning	The Domains List have changed. Check agent properties and validate the change.	Validate the domains list in the secondary agent properties.
PS_AMON_304	Critical	Failed to install domain agent.	This is an internal problem. Contact Dell Support.
PS_AMON_305	Critical	Invalid PeopleSoft Home Directory.	The agent will break. Verify the PeopleSoft enterprise home; by checking that the binary <PS_HOME>/appserv/psadmin exists.
PS_AMON_306	Critical	Invalid Tuxedo Home Directory	The agent will break. Verify the Tuxedo home path; by checking that the binary <TUX_HOME>/bin/BBL exists.
PS_AMON_307	Warning	<Instance Name> was previously deployed at <Date Signature> and it will not be redeployed. To redeploy, uncheck the Domain in the Domain List ASP and recheck.	The Agent was deployed in the past and was deleted without setting Deploy to false in the AppMonitor agent. Edit list of domains and set Deploy to false. If you are interested and start monitoring this domain again, set the Deploy option to true.
PS_AMON_308	Critical	Agent <Agent_Name> Version/DCMs mismatched <Agent_Version> / <DCM_Version> .Agent Shut Down	There is a problem in the installation of the agent due to mismatch between agent and DCM. Contact Dell Support.
PS_AMON_310	Informational	Successful Data Collection.	Internal message.
PS_AMON_999	Critical	Failed to initialize icu adapter validate resource file.	Contact Dell Support and verify installation status.

PS_AppServer Agent Data Tables

The PS_AppServer agent contains the following tables:

•

PS_AppServer AgentMsgs Data Table

•

AppServer_Process_Details Data Table

•

Clients Data Table

•

DomainConfiguration Data Table

•

DomainTotals Data Table

•

LogMessages Data Table

•

Queue_Process_Totals Data Table

•

Services Data Table

PS_AppServer AgentMsgs Data Table

The AgentMsgs (Agent Messages) Table logs information about the PS_AppServer agent.


Field	Description
Message	The text provided by the agent describing the error condition. It displays in the agent error rule.
MessageID	The unique agent message ID. Each error starts with an agent prefix followed by a three-digit number, for example, Oracle = ORA001, Sybase = SYB002, Weblogic6 = WLS6001. Refer to the following tables for the PeopleSoft agent message numbers and descriptions.
Severity	Severity of the agent error condition, for example, Informational, Warning, Critical, Fatal.
MsgCnt	Number of Identical Message for current collection cycle—helps to avoid messages storms.

The following are the PS_AppServer agent error messages:


Message ID	Severity	Message Text	User Action
PS_ASRV_201	Warning	The Process List Name that is being used is generic. It is recommended to create a unique list name as follows <AgentName><HostName>	The agent continues execute and collect data based on the Process List Name. It is recommended to use a unique name for the process list.
PS_ASRV_202	Critical	Invalid PeopleSoft Home Directory.	The agent will break. Verify the PeopleSoft enterprise home; by checking that the binary <PS_HOME>/appserv/psadmin exists.
PS_ASRV_203	Critical	Invalid Tuxedo Home Directory.	The agent will break. Verify the Tuxedo home path; by checking that the binary <TUX_HOME>/bin/BBL exists.
PS_ASRV_204	Warning	The process list has changed. Check agent property and validate the change.	Review the change to the secondary agent property process list.
PS_ASRV_205	Critical	Invalid ASP for Domain Config File.	Verify configuration file exists in the agent property.
PS_ASRV_206	Critical	Failed to find psappsrv.ubb file.	Verify that the domain information is correct, including a valid .ubb file in the domain directory.
PS_ASRV_207	Critical	Failed to get the tuxedo config file.	Verify the Tuxedo configuration file exists and is readable.
PS_ASRV_208	Critical	Failed to find log directory.	The Log Directory is not found. Verify agent property values.
PS_ASRV_209	Warning	Failed to read tuxedo log (TUXLOG.MMDDYY.	Failed to read the Tuxedo log for today from the log directory. Verify that is exists and permissions.
PS_ASRV_210	Critical	Agent <Agent_Name> Version/DCMs mismatched <Agent_Version> / <DCM_Version>.Agent Shut Down	There is a problem in the installation of the agent due to a mismatch between agent and DCM. Contact Dell Support.
PS_ASRV_211	Warning	Number of clients to monitor exceed the hard limit. Please set a value less than or equal to <ASP hidden value: Max client>.	Agent continues to collect data, but does not exceed the maximum value.
PS_ASRV_212	Critical	Failed to connect to tuxedo domain.	Failed to connect to Tuxedo domain. Verify that Tuxedo is up and running and the user has the correct permission to connect to Tuxedo. If running as non-root, refer to the non-root installation procedure in the Release Notes.
PS_ASRV_214	Warning	LDBAL value in the psappsrv.ubb file is not turned on. The Services Table information is not applicable and not displayed.	Turn LDBAL on in the psappsrv.ubb file.
PS_ASRV_218	Informational	Successful Data Collection.	Internal message.
PS_ASRV_999	Critical	Failed to initialize icu adapter validate resource file.	Contact Dell Support and verify installation status.

AppServer_Process_Details Data Table

The AppServer_Process_Details Table logs information about the PS_AppServer agent.


Field	Description
ActiveRequests	The number of requests initiated by the server via tpcall(3c) or tpacall(3c) that are still active at the time of data collection. Active requests represent the number of requests that are made by the application server process.
PS_Domain	The name of the domain containing the application process being monitored.
Percent_CPU	The percentage of CPU resources used by a process.
Percent_Memory	The percentage of memory used by a process.
Process	The name of the process being monitored.
Process_ID	The number given by the system to this process.
Process_Unique	The name of the process and the process ID.
Requests	The number of requests made by the server via tpcall(3c) or tpacall(3c) at the time of data collection. Requests represent the number of requests that are made by the application server process.
RequestsCompleted	The total number of requests completed by the server at the time of data collection. Requests completed is the number of client service requests that are processed and completed by the application server process advertising those particular services at the time of data collection.
ResidentSetSize	The amount of physical memory that the process used, in kilobytes.
ServerPath	The fully qualified path name of the server executable. This is usually the name of the application server process (PSAPPSRV, PSSAMSRV, and so on).
Uptime	The number of hours the process is running.
VirtualSetSize	The amount of swap memory that the process used, in kilobytes.
WorkCompleted	The total work load completed by the application server process at the time of data collection. Work completed is the requests completed multiplied by the load factor (typically, 50).

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating