To access: AppDynamics Home > Servers > double-click server > Processes
You can configure which processes AppDynamics monitors, how they are grouped, number of processes to monitor, and how long they must be alive before monitoring them. For more information, see Machine Agent Settings for Server Visibility.
On the Server Processes tab you can:
- View all the processes active during the selected time period. The processes are grouped by class as specified in the ServerMonitoring.yml file.
- View the full command line that started this process by hovering over the process entry in the Command Line column.
- Expand a process class to see the processes associated with that class.
- Use View Options to configure which columns to display in the chart.
- Change the time period of the metrics displayed.
- Sort the chart using the columns as a sorting key. You can not sort on sparkline charts: CPU Trend and Memory Trend.
- See CPU and Memory usage trends at a glance
Metrics for Server Processes
The following information is presented for each monitored class and process:
- Class: The process class
- Count: The number of processes in this class.
- Command Line: The command that started the process.
- State: An icon represents the process state: sleeping, running, terminated, zombie or multiple. However over the icon to learn its meaning. The State column displays a question mark when there are more than one process associated with the class. Expand the class to see the state of the related processes.
- Effective User: The name of the user account that started the process.
- Start Time: The time, as set on the Controller machine, when the process started.
- End Time: The time, as set on the Controller machine, when the process ended.
- CPU (%): The percentage of CPU resources by all process in this class.
- CPU Trend: A chart that shows CPU usage over the selected time period.
- Memory (%): The percentage of memory resources by all process in this class.
- Memory Trend: A chart that shows memory usage over the selected time period.
- PID: Process ID.
- PPID: ID of the parent process.
The following column information is specific to processes monitored on a Linux server.
- pgid: Process group ID.
- Real Group: The process real user ID.
- Real User: The process real user ID.
- Effective Group: The user ID the kernel uses to determine the process permissions when using shared resources such as message queues, shared memory, and semaphores.
- Nice Level: The priority used to indicate the amount of CPU to afford the process or the process priority, where -20 is the highest priority and 19 or 20 is the lowest priority.
Windows Process Collection Configuration
When too many processes slow down performance of the Machine Agent on Windows, you will need to adjust the system environment variables to accommodate. Specifically, in relation to Windows-based operating systems supported by the AppDynamics platform. See System Requirements.
Microsoft Windows process collection is enabled by default in the Controller and is missing the Effective User value due to performance issues. If you want to retrieve the Effective User value, set the
APPDYNAMICS_ENABLE_PROCESS_OWNER_INFORMATION environment variable. Although you can retrieve this information, this will most likely slow your process collection and may lead to additional issues, such as high cpu usage and the failure to report metrics. To disable process collection altogether, set the
APPDYNAMICS_MACHINE_AGENT_STOP_PROCESS_COLLECTION, which will speed up your performance at the expense of losing process metrics and metadata.
Windows System Environment Variables
This information is specific to processes monitored on a Windows server.
- Default: Retrieve all Windows processes and metadata. Starting with Machine Agent 4.5.4, the Effective User information is excluded by default to improve performance.
APPDYNAMICS_ENABLE_PROCESS_OWNER_INFORMATION: Retrieve all Windows processes and metadata, including the Effective User, but the Machine Agent may experience performance issues. This is available starting with Machine Agent 4.5.4.
APPDYNAMICS_MACHINE_AGENT_STOP_PROCESS_COLLECTION: Stops all Windows process metrics and metadata collection, but improves Machine Agent performance. If this variable is set then the
APPDYNAMICS_ENABLE_PROCESS_OWNER_INFORMATIONvariable is ignored. This is available starting with Machine Agent 4.4.0.
These environment variables only need to be set, you do not need to assign a value to the variable.
The Machine Agent will need to be restarted for these changes to take effect.