IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft.NET Framework Agent Fix Pack 13.

Transcription

1 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft.NET Framework Agent Fix Pack 13 Reference IBM

2

3 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft.NET Framework Agent Fix Pack 13 Reference IBM

4 Note Before using this information and the product it supports, read the information in Notices on page 429. This edition applies to version of IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft.NET Framework Agent (product number 5724-U17) and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 2008, US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Tables v Chapter 1. Workspaces reference Predefined workspaces Workspace descriptions Microsoft.NET Framework Navigator item... 3 ASP NET Navigator item ASP NET Applications Navigator item Event Log Navigator item NET CLR Exceptions Navigator item NET CLR Interop Navigator item NET CLR Jit Navigator item NET CLR Loading Navigator item NET CLR Memory Navigator item NET CLR Networking Navigator item NET CLR Remoting Navigator item NET CLR Security Navigator item NET CLR Threads Navigator item NET Data Provider Navigator item NET Memory Cache Navigator item NET Process Navigator item Performance Object Status Navigator item Windows Communication Foundation Navigator item Windows Workflow Foundation Navigator item 15 Cross-linked workspaces Chapter 2. Attributes reference Attribute groups for the monitoring agent Attributes in each attribute group ASP.NET Applications Error Filter attribute group ASP.NET Applications Filter attribute group.. 24 ASP.NET Applications V1.1 attribute group ASP.NET Applications V2.0 attribute group ASP.NET Applications V bit attribute group 71 ASP.NET Applications V bit Error attribute group ASP.NET Applications V4.0 attribute group ASP.NET Applications V4.0 - WebSockets attribute group ASP.NET Applications V4.0 Error attribute group ASP.NET Filter attribute group ASP.NET V1.1 attribute group ASP.NET V2.0 attribute group ASP.NET V bit attribute group ASP.NET V4.0 attribute group Event Log attribute group NET CLR Exceptions attribute group NET CLR Interop attribute group NET CLR Jit attribute group NET CLR Loading attribute group NET CLR Memory attribute group NET CLR Networking attribute group NET CLR Networking Filter attribute group NET CLR Networking V4.0 attribute group NET CLR Remoting attribute group NET CLR Security attribute group NET CLR Threads attribute group NET Components attribute group NET Data Provider Filter attribute group NET Data Provider for Oracle attribute group 182 NET Data Provider For SQL Server attribute group NET Memory Cache V4.0 attribute group NET Process attribute group Performance Object Status attribute group Service Model Endpoint attribute group Service Model Endpoint Filter attribute group 212 Service Model Endpoint V4.0 attribute group 218 Service Model Operation attribute group Service Model Operation Filter attribute group 230 Service Model Operation V4.0 attribute group 235 Service Model Service attribute group Service Model Service Filter attribute group Service Model Service V4.0 attribute group Service Model Svc Host attribute group Service Model Svc Host Filter attribute group 284 Service Model Svc Host V4.0 attribute group 292 Windows Workflow Foundation attribute group 300 Windows Workflow Foundation Filter attribute group Windows Workflow Foundation V4 attribute group Workflow ServiceHost V4 attribute group Disk capacity planning for historical data Chapter 3. Situations reference Predefined situations Situation descriptions ASP NET Navigator item ASP NET Applications Navigator item Event Log Navigator item NET CLR Exceptions Navigator item NET CLR Jit Navigator item NET CLR Loading Navigator item NET CLR Memory Navigator item NET CLR Threads Navigator item NET Process Navigator item Windows Communication Foundation Navigator item Chapter 4. Take Action commands reference Predefined Take Action commands Chapter 5. Policies reference Predefined policies Copyright IBM Corp. 2008, 2017 iii

6 Chapter 6. Tivoli Common Reporting for the monitoring agent Cognos-based report packages Prerequisites for installing and running packages Extracting the package Importing Cognos report packages Cognos data models and reports Chapter 7. Event mapping Appendix A. Discovery Library Adapter for the Microsoft.NET Framework agent DLA data model class types represented in CDM 423 DLA data model classes for Microsoft.NET Framework agent Appendix B. ITCAM for Microsoft Applications documentation library Prerequisite publications Related publications Tivoli Monitoring Community on Service Management Connect Other sources of documentation Notices Trademarks Terms and conditions for product documentation 431 IBM Online Privacy Statement Index iv The Microsoft.NET Framework agent Reference

7 Tables 1. Cross-linked workspaces within the Microsoft.NET Framework agent Capacity planning for historical data logged by the Microsoft.NET Framework agent NET Framework Agent Reports Prerequisites Scanner Performance Details of.net Applications for Single Resource report Bad Messages Details report Transactions Details report Request Status for Single Resource report Resource Comparison by.net Applications Performance report Top.NET Applications by Performance for Multiple Resources report Request Status Summary by Server Name report Connection Cycle Details report Security Calls Details report Resource Utilization Comparisons for.net Applications report Copyright IBM Corp. 2008, 2017 v

8 vi The Microsoft.NET Framework agent Reference

9 Chapter 1. Workspaces reference A workspace is the working area of the Tivoli Enterprise Portal application window. The Navigator tree contains a list of the workspaces provided by the agent. About workspaces Use the Navigator tree to select the workspace you want to see. As part of the application window, the status bar shows the Tivoli Enterprise Portal Server name and port number to which the displayed information applies and the ID of the current user. When you select an item in the Navigator tree, a default workspace is displayed. When you right-click a Navigator item, a menu that includes a Workspace item is displayed. The Workspace item contains a list of workspaces for that Navigator item. Each workspace has at least one view. Some views have links to other workspaces. You can also use the Workspace Gallery tool as described in the Tivoli Enterprise Portal User's Guide to open workspaces. The workspaces in the Navigator are displayed in a Physical view that shows your enterprise as a physical mapping or a dynamically populated logical view that is agent-specific. You can also create a Logical view. The Physical view is the default view. This monitoring agent provides predefined workspaces. You cannot modify or delete the predefined workspaces, but you can create new workspaces by editing them and saving the changes with a different name. Workspace views can be any combination of query-based views, event views, and special purpose views. Additional information about workspaces For more information about creating, customizing, and working with workspaces, see "Using workspaces" in the Tivoli Enterprise Portal User's Guide. For a list of the predefined workspaces for this monitoring agent and a description of each workspace, see Predefined workspaces and the information about each individual workspace. Some attribute groups for this monitoring agent might not be represented in the predefined workspaces or views for this agent. For a full list of the attribute groups, see Attribute groups for the monitoring agent on page 17. Predefined workspaces The Microsoft.NET Framework agent provides predefined workspaces, which are organized by navigator item. v Microsoft.NET Framework navigator item Microsoft.NET Framework workspace NET Components workspace v ASP NET navigator item ASP NET workspace ASP.NET 64 bit workspace ASP.NET 64 bit Details workspace ASP.NET Details workspace Copyright IBM Corp. 2008,

10 ASP.NET v1.1 workspace ASP.NET v1.1 Details workspace v ASP NET Applications navigator item ASP NET Applications workspace ASP.NET Applications 64 bit workspace ASP.NET Applications Cache Utilization workspace ASP.NET Applications Cache Utilization 64 bit workspace ASP.NET Applications Request Status workspace ASP.NET Applications Request Status 64 bit workspace ASP.NET Applications Session State workspace ASP.NET Applications Session State 64 bit workspace ASP.NET Applications v1.1 workspace ASP.NET Applications v1.1 Cache Utilization workspace ASP.NET Applications v1.1 Request Status workspace ASP.NET Applications v1.1 Session State workspace v Event Log navigator item Event Log workspace v NET CLR Exceptions navigator item NET CLR Exceptions workspace v NET CLR Interop navigator item NET CLR Interop workspace v NET CLR Jit navigator item NET CLR Jit workspace v NET CLR Loading navigator item NET CLR Loading workspace NET CLR Loading Details workspace v NET CLR Memory navigator item NET CLR Memory workspace NET CLR Memory Details workspace NET CLR Memory Leaks and Fragmentations workspace v NET CLR Networking navigator item NET CLR Networking workspace v NET CLR Remoting navigator item NET CLR Remoting workspace NET CLR Remoting Details workspace v NET CLR Security navigator item NET CLR Security workspace v NET CLR Threads navigator item NET CLR Threads workspace NET CLR Threads Details workspace v NET Data Provider navigator item NET Data Provider workspace v NET Memory Cache navigator item NET Memory Cache workspace v NET Process navigator item 2 The Microsoft.NET Framework agent Reference

11 NET Process workspace v Performance Object Status navigator item Performance Object Status workspace v Windows Communication Foundation navigator item Service Model Operation workspace Service Model Service workspace Service Model Svc Host workspace Windows Communication Foundation workspace v Windows Workflow Foundation navigator item Windows Workflow Foundation workspace Workspace descriptions Each workspace description provides information about the workspace such as the purpose and a list of views in the workspace. Workspaces are listed under Navigator items. Microsoft.NET Framework Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. Microsoft.NET Framework workspace This workspace displays the overall state of the.net Framework. This workspace contains the following views: Memory Usage This bar chart displays the memory usage for the.net processes. High reserved memory indicates that a number of resources are yet to be cleaned. An increase in Total Reserved Bytes over a large period of time suggests fragmentation of the virtual address space. Performance Penalty This bar chart indicates the performance penalty that the application incurs when performing security checks. Run-time code access security checks are performed when a caller demands a particular permission. The run-time check is made on every call by the caller and examines the current thread stack of the caller. Thread Contention Rate This plot chart indicates the rate at which threads in the run time attempt to acquire a managed lock unsuccessfully. Sustained nonzero values can be a cause of concern. Response Time This plot chart helps in identifying throughput degradation and increased response time if values of Requests Execution time and Requests Wait time are higher. Exception Thrown Per Second This bar chart indicates the number of Exceptions thrown per second by every application. If the application throws more than 100 exceptions per second, the performance of the system starts degrading. Make sure that more than 100 exceptions are not thrown per second. When the value exceeds 100, you can take some actions so that it does not reach 500, which is the critical state. A value of more than 500 degrades the performance severely. NET Components workspace The workspace provides the details of.net Components installed on managed system. This workspace contains the following view:.net Components Installed This report displays the.net Components available on the computer including.net Frameworks installed, ASP.NET versions available, fix packs, hotfixes, and service packs installed. Chapter 1. Workspaces reference 3

12 ASP NET Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. ASP NET workspace This workspace is used to measure network utilization, response time, and throughput of CPU, memory, and disk I/O of ASP.NET V2.0 and ASP.NET V4.0 applications.the following reports and graphs are included in the workspace: This workspace contains the following views: ASP.NET Request Status This bar chart displays the status of ASP.NET requests. Higher values of Requests Current, Requests Queued, and Requests Rejected indicate throughput degradation and increased response time. Response Time This plot chart displays the throughput degradation and increased response time if values of Requests Execution time and Requests Wait time are higher. ASP.NET 64 bit workspace This workspace is used to measure the throughput in terms of CPU, memory, disk I/O, and network utilization and response time.this workspace is visible only if you select Workspace Administration Mode. This workspace contains the following views: ASP.NET Request Status This bar chart helps identify the status of ASP.NET 64 bit requests. Higher values of Requests Current, Requests Queued, and Requests Rejected indicate throughput degradation and increased response time. Response Time This plot chart helps identify throughput degradation and increased response time if values of Requests Execution time and Requests Wait time are higher. ASP.NET 64 bit Details workspace This workspace helps identify resources and time consumption.this workspace is visible only if you select Workspace Administration Mode. This workspace contains the following views: Application and Worker Process Restarts This bar chart helps identify resources and time consumed by ASP.NET 64 bit applications. ASP.NET Details This report contains all performance counters of ASP.NET. It helps identify overall performance of the ASP.NET 64 bit applications. ASP.NET Details workspace This workspace is used to identify resources and time consumption for ASP.NET V2.0 and ASP.NET V4.0 applications.the following reports and graphs are included in the workspace: This workspace contains the following views: Application Restarts and Worker Process Restarts This bar chart displays resources and time consumed by ASP.NET applications. ASP.NET Details This report displays the performance counters of ASP.NET applications. ASP.NET v1.1 workspace This workspace is used to measure the throughput in terms of CPU, memory, disk I/O, and network utilization and response time. The following reports and graphs are included in the workspace. This workspace contains the following views: ASP.NET Request Status This bar chart helps identify the status of ASP.NET v requests. Higher values of Requests Current, Requests Queued, and Requests Rejected indicate throughput degradation and increased response time. 4 The Microsoft.NET Framework agent Reference

13 Response Time This plot chart helps identify throughput degradation and increased response time if values of Requests Execution time and Requests Wait time are higher. ASP.NET v1.1 Details workspace This workspace helps identify resources and time consumption. The following reports and graphs are included in the workspace: This workspace contains the following views: Application and Worker Process Restarts This bar chart helps identify resources and time consumed by ASP.NET v applications. ASP.NET Details This report contains all performance counters of ASP.NET. It helps identify overall performance of the ASP.NET v applications. ASP NET Applications Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. ASP NET Applications workspace This workspace is used to measure the performance and throughput of ASP.NET V2.0 and ASP.NET V4.0 applications.the following reports and graphs are included in the workspace: This workspace contains the following views: Application Performance This report displays the performance related attributes. Application Throughput Details This report displays detailed information about the ASP.NET application performance that are under load. Error Status This report displays detailed information about the errors that occurred during the ASP.NET application lifetime. Application Throughput This bar chart displays the number of requests that can be processed concurrently for a given application and the current throughput of an application that is under constant load. Errors Per Second This plot chart displays the errors that occur when the application is running. ASP.NET Applications 64 bit workspace This workspace is used to measure the performance and throughput of ASP.NET 64-bit applications.this workspace is visible only if you select Workspace Administration Mode. This workspace contains the following views: Application Performance This report helps an administrator to see all of the performance-related attributes at once. Application Throughput Details This report displays an administrator detailed information about the ASP.NET 64-bit Application performance under load. Error Status This report displays an administrator detailed information about the errors that occurred during the ASP.NET 64-bit application lifetime. Application Throughput This bar chart displays the number of requests that can be processed concurrently for a given application and the current throughput of the application under constant load. Errors Per Second This plot chart displays the number of errors that occured during the time of execution. Chapter 1. Workspaces reference 5

14 ASP.NET Applications Cache Utilization workspace This workspace provides detailed information about the cache mechanism that is used for ASP.NET V2.0 and ASP.NET V4.0 applications.the following reports and graphs are included in the workspace: This workspace contains the following views: Cache Turnovers This bar chart indictaes that a higher turnover rate of cache means cache memory is not managed properly. Cache Hit Ratio This bar chart indicates that a low ratio of cache hit-to-miss means the caching techniques are not used efficiently. Cache Total This report provides detailed information about the entries in the cache for ASP.NET applications. Cache API This report provides detailed information about the entries in the cache for ASP.NET applications. Output Cache This report provides detailed information about the entries in the output cache for ASP.NET applications. ASP.NET Applications Cache Utilization 64 bit workspace This workspace provides detailed information about how effectively the cache mechanism has been used for ASP.NET Applications.This workspace is visible only if you select Workspace Administration Mode. This workspace contains the following views: Cache Turnovers In this bar chart, higher turnover rate of cache means cache memory is not managed properly. Cache Hit Ratio This bar chart indicates that a low ratio of cache hit-to-miss means inefficient use of caching techniques. Cache Total This report gives detailed information about the entries in the cache which includes both user and internal entries for an ASP.NET Application. Cache API This report gives detailed information about the entries in the cache through external cache APIs for an ASP.NET Application. Output Cache This report gives detailed information about the entries in the output cache for an ASP.NET Application. ASP.NET Applications Request Status workspace This workspace displays the requests that are made to ASP.NET V2.0 and ASP.NET V4.0 applications.the following reports and graphs are included in the workspace: This workspace contains the following views: Request Status This bar chart displays the status of requests that are made to a Web application. Request Status Details This report displays detailed information about the status of requests that are made to ASP.NET applications. ASP.NET Applications Request Status (WebSockets) workspace This workspace provides information about the requests that are made to the ASP.NET applications by using the WebSocket protocol. The following reports and graphs are included in the workspace: This workspace contains the following views: 6 The Microsoft.NET Framework agent Reference

15 Request Status (WebSockets) This bar chart displays the status of the requests that are made to the ASP.NET applications by using the WebSocket protocol. Request Status Details (WebSockets) This report displays detailed information about the status of the requests that are made to the ASP.NET applications by using the WebSocket protocol. ASP.NET Applications Request Status 64 bit workspace An administrator can obtain all the required information related to the requests made to an ASP.NET Application through this workspace.this workspace is visible only if you select Workspace Administration Mode. This workspace contains the following views: Request Status This bar chart is useful for obtaining the status of various requests made to a Web application. Request Status Details This report gives an administrator detailed information about the status of requests made to an ASP.NET Application. ASP.NET Applications Session State workspace This workspace provides detailed information about the sessions that are maintained for ASP.NET V2.0 and ASP.NET V4.0 applications.the following reports and graphs are included in the workspace: This workspace contains the following views: Sessions Abandoned or Timed Out This bar chart displays the status of sessions during the execution of ASP.NET applications. Sessions are stored in the memory allocated for application execution. Active Sessions This plot chart displays the number of active user sessions while the application is running. Sessions Details This report displays detailed information about the status of requests made to ASP.NET applications. ASP.NET Applications Session State 64 bit workspace This workspace provides detailed information about how effectively sessions have been maintained for an ASP.NET Application.This workspace is visible only if you select Workspace Administration Mode. This workspace contains the following views: Sessions Abandoned or Timed Out This bar chart shows the status of all sessions during execution of an ASP.NET Application. Sessions are stored in memory allocated for application execution. Active Sessions This plot chart shows the number of active user sessions while the application is running that helps you make business decisions from a provisioning point of view. Sessions Details This report gives detailed information about the status of requests made to an ASP.NET Application. ASP.NET Applications v1.1 workspace This workspace is used to measure the performance and throughput of ASP.NET v applications. The following reports and graphs are included in the workspace: This workspace contains the following views: Application Performance This report helps an administrator to see all of the performance related attributes at once. Application Throughput Details This report gives an administrator detailed information about the ASP.NET v Application performance under load. Chapter 1. Workspaces reference 7

16 Error Status This report gives an administrator detailed information about the errors that occurred during the ASP.NET v application lifetime. Application Throughput This bar chart represents how many requests can be processed concurrently for a given application and the current throughput of the application under constant load. Errors Per Second This plot chart displays higher rate of errors occurring at the time of execution indicate unexpected behavior of an application that directly affects the performance. ASP.NET Applications v1.1 Cache Utilization workspace This workspace provides detailed information about how effectively the cache mechanism has been used for ASP.NET v Applications. The following reports and graphs are included in the workspace: This workspace contains the following views: Cache Turnovers In this bar chart, a higher turnover rate of cache means cache memory is not managed properly. Cache Hit Ratio This bar chart indicates that a low ratio of cache hit-to-miss means inefficient use of caching techniques. Cache Total This report gives detailed information about the entries in the cache, which includes both user and internal entries for an ASP.NET v Application. Cache API This report gives detailed information about the entries in the cache through external cache APIs for an ASP.NET v Application. Output Cache This report gives detailed information about the entries in the output cache for an ASP.NET v Application. ASP.NET Applications v1.1 Request Status workspace An administrator can obtain all of the required information related to the requests made to an ASP.NET Application v through this workspace. The following reports and graphs are included in the workspace: This workspace contains the following views: Request Status This bar chart is useful for obtaining the status of various requests made to a Web application. Request Status Details This report gives an administrator detailed information about the status of requests made to an ASP.NET v Application. ASP.NET Applications v1.1 Session State workspace This workspace provides detailed information about how effectively sessions have been maintained for an ASP.NET v Application. The following reports and graphs are included in the workspace: This workspace contains the following views: Sessions Abandoned or Timed Out This bar chart shows the status of all sessions during execution of an ASP.NET v Application. Sessions are stored in memory allocated for application execution. Active Sessions This plot chart shows the number of active user sessions while the application is running that help you make business decisions from a provisioning point of view. Sessions Details This report gives detailed information about the status of requests made to an ASP.NET v Application. 8 The Microsoft.NET Framework agent Reference

17 Event Log Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. Event Log workspace The Event Log workspace shows the details for the recent events logged by the application to the Windows Event Log. By default, the agent only displays events that occur after the agent is started. Events are removed from the Event Log view 1 hour after they occur. This workspace contains the following view: Event Log Shows the recent Event Log entries for Microsoft.NET Framework. NET CLR Exceptions Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. NET CLR Exceptions workspace This workspace provides an overview of the total exceptions thrown since an application started, exceptions thrown per second, and so on. The following reports and graphs are included in the workspace. This workspace contains the following views: Exceptions Details This report lists all of the performance counters related to Exceptions thrown in every application. The threshold value is set for the Number of Exceps Thrown per Sec attribute. If the value of this counter exceeds 100, it provides a warning. If this counter exceeds 500, the status changes to critical, because many exceptions thrown per second can degrade performance severely. Exceptions Thrown This bar chart indicates the total number of exceptions thrown in every application. By looking at this graph you can figure out which application is throwing a large number of exceptions and avoid performance degradation. Exceptions Thrown Per Second This bar chart indicates the number of Exceptions thrown per second by every application. If the application throws more than 100 exceptions per second, the performance of the system starts degrading. Make sure that more than 100 exceptions are not thrown per second. When the value exceeds 100, you can take some actions so that it does not reach 500, which is the critical state. A value of more than 500 degrades the performance severely. Throw To Catch Depth Per Second This bar chart displays the number of stack frames traversed, from the frame that threw the exception to the frame that handled the exception per second. NET CLR Interop Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. NET CLR Interop workspace This workspace provides an overview of the interoperability for each application. It shows the number of marshalling, stubs, and COM Callable Wrappers used for interoperability. The following reports and graphs are included in the workspace. This workspace contains the following views: Interoperability Details This report lists all of the performance counters related to Interoperability for every application. It shows the number of times marshalling occurs for transitions from managed to unmanaged code and from unmanaged to managed code, the number of stubs required for marshalling, the number of COM Callable Wrappers, and so on. A large number of marshalling and stubs might degrade performance. Chapter 1. Workspaces reference 9

18 Interoperability The bar chart shows the Interoperability parameters for every application. The large number of marshalling and stubs might degrade performance. NET CLR Jit Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. NET CLR Jit workspace This workspace displays the status of CLR JIT. Just-in-time (JIT) compilation is used to compile IL methods to native computer language immediately before implementing the methods. This workspace contains the following views: JIT Failures This bar chart displays JIT failures for the.net processes. Standard JIT failures indicate that the.net framework version is corrupted and needs to be updated. JIT Details This report lists all of the JIT attributes. NET CLR Loading Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. NET CLR Loading workspace This workspace provides an overview of the load failures for each application. It shows rate of assemblies loaded, rate of load failures, total load failures, and so on. The following graphs are included in the workspace. This workspace contains the following views: Rate of Load Failures This bar graph indicates the rate of failures while loading classes since the application started. Memory Committed by Appdomains This bar graph indicates the size of memory committed across all application domains. NET CLR Loading Details workspace This workspace provides an overview of components such as the Application Domains and Assemblies that were loaded since the applications started. The following graphs are included in the workspace. This workspace contains the following views: Application Domains The graph indicates the total number of Application Domains for all applications. This is a stacking bar chart. The lower part of the graph (yellow color) indicates the current application domains that were loaded, and the upper part of the graph (blue color) indicates the total number of application domains that were unloaded. The addition of these values gives the total number of application domains since the application started. Assemblies The graph indicates the total number of Assemblies for all applications. This is a stacking bar chart. The lower part of the graph (yellow color) indicates the current assemblies that were loaded, and the upper part of the graph (blue color) indicates the total number of assemblies that were unloaded. The addition of these values gives the total number of assemblies since the application started. Loading Details This report lists all of the performance counters related to loading and unloading that have taken place in every application. NET CLR Memory Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. 10 The Microsoft.NET Framework agent Reference

19 NET CLR Memory workspace This workspace provides an overview of memory management for the.net environment. The following reports and graphs are included in the workspace. This workspace contains the following views: Memory Usage (memory in use and reserved) This bar chart displays the memory usage for the.net processes. High reserved memory indicates that a number of resources are yet to be cleaned. An increase in Total Reserved Bytes over a large period of time suggests fragmentation of the virtual address space. Memory Management Activity This bar chart displays the memory management activity. Time in GC shows the percentage of time spent in Garbage Collection (GC) since the end of the last GC. The chart indicates unproductive activity caused by memory-related problems. This chart also indicates the CPU load. External Resources Utilization This bar chart indicates the external resources utilization (outside managed environment). Increasing values indicate a number of unmanaged (external) resources, which might not be cleaned up. A high value of pinned objects indicates that these objects are shared to an external (unmanaged) environment. NET CLR Memory Details workspace This workspace lists all of the performance attributes of CLR Memory focused on different heaps. This workspace contains the following views: Memory Details This report lists all of the performance attributes of the CLR GC. It also includes several thresholds for most of the attributes. Memory Collections This is a bar chart that displays the memory collections or garbage collections for.net processes. According to the implementation of GC, there are three generations of heaps. Collection process (compaction) triggers the heaps when required. Memory Heaps This bar chart displays the snapshot of managed heaps that includes Gen 0 heap, Gen 1 heap, Gen 2 heap, and Large Object Heap. NET CLR Memory Leaks and Fragmentations workspace This workspace helps you identify memory leaks and fragmentations caused by common problems. This workspace contains the following views: Memory Leaks and Fragmentations Indicators Details This report lists the details of the counters that help indicate memory leaks and fragmentation. Memory Leaks and Fragmentations Indicators This bar chart includes all of the memory leaks and fragmentation indicators. Constantly increasing values of these parameters indicate memory leaks and fragmentations. NET CLR Networking Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. NET CLR Networking workspace This workspace provides an overview of the current state of the Networking activity in the.net environment. The following reports and graphs are included in the workspace. This workspace contains the following views: Networking Details This report lists all of the performance counters related to Networking in the.net processes. Bytes Transferred This bar graph indicates the number of bytes sent and received by the.net processes. Chapter 1. Workspaces reference 11

20 Datagrams Transferred This bar graph indicates the number of datagrams sent and received by the.net processes. Connections Established This bar graph indicates the number of socket connections established by the.net processes. NET CLR Remoting Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. NET CLR Remoting workspace This workspace provides an overview of the current state of the Remoting activity in the.net environment. The following reports and graphs are included in the workspace. This workspace contains the following views: Remoting Channels This bar chart indicates the total number of Remoting channels registered across all application domains since the application started. Channels transport messages to and from remote objects. Remote Calls This bar chart indicates the total number of remote procedure calls invoked since the application started. A remote procedure call is a call on any object outside the caller's application domain. NET CLR Remoting Details workspace This workspace provides an overview of the current state of the Remoting activity in the.net environment. The following graphs are included in the workspace. This workspace contains the following views: Remoting Details This report lists all of the performance counters related to Remoting in the.net processes. Remote Calls Per Sec This plot chart indicates the number of remote calls made per second by the.net processes. A remote procedure call is a call on any object outside the caller's application domain. NET CLR Security Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. NET CLR Security workspace This workspace provides an overview of the current state of the Security checking activity in the.net environment. The following reports and graphs are included in the workspace. This workspace contains the following views: Code Access Security Details This report lists all of the performance counters related to Security in the.net processes. Security Checks This bar chart indicates the percentage of elapsed time spent performing run-time code access security checks. Performance Penalty This bar chart indicates the performance penalty that the application incurs when performing security checks. run-time code access security checks are performed when a caller demands a particular permission. The run-time check is made on every call by the caller and examines the current thread stack of the caller. NET CLR Threads Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. 12 The Microsoft.NET Framework agent Reference

21 NET CLR Threads workspace This workspace provides an overview of the current state of the threads running in the.net environment. The following reports and graphs are included in the workspace. This workspace contains the following views: Logical and Physical Threads This bar chart indicates the number of Logical threads and the number of Physical threads that the.net process CLR has spawned. Logical threads are managed thread objects in the process. If the logical thread count for an application is increasing unexpectedly, thread stacks might be leaking. Physical threads are native operating system threads that are created and owned by the common language run time, and act as underlying threads for managed thread objects. Waiting Threads This plot chart indicates the number of threads in the.net process that are waiting to acquire a lock. As the number of waiting threads increases, performance degrades. NET CLR Threads Details workspace This workspace provides an overview of the current state of the threads running in the.net environment. The following reports and graphs are included in the workspace. This workspace contains the following views: Threads Details This report lists all of the performance counters related to locks and threads in the.net processes. Thread Contention Rate This plot chart indicates the rate at which threads in the run time attempt to acquire a managed lock unsuccessfully. Sustained nonzero values can be a cause of concern. NET Data Provider Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. NET Data Provider workspace This workspace provides information about the connections that are made to the SQL Server and the Oracle Server.The following reports and graphs are included in the workspace: This workspace contains the following views: Connection: Hard vs Soft This plot chart displays the rate of change in the number of hard connections and soft connections. Pooled and Non Pooled Connections This bar chart displays the number of pooled and non pooled connections. Data Provider Details This report displays the performance counters related to the.net Data Provider for SQL Server and Oracle Server attribute groups. NET Memory Cache Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. NET Memory Cache workspace This workspace provides an overview of the in-memory cache details of.net Framework 4.0. This workspace contains the following views: Cache Hits Ratio This bar chart indicates that a low ratio of cache hits indicates an inefficient use of caching techniques. Cache Turnover Rate This bar chart indicates that a high turnover rate of cache means cache memory is not managed correctly. Chapter 1. Workspaces reference 13

22 Cache Hits and Misses Per Sec This bar chart indicates that a lower number of cache hits per second or a higher number of caches misses per second indicates an inefficient use of caching techniques. Memory Cache Details This report provides details about the in-memory cache of.net Framework 4.0, such as number of cache entries, cache hits, cache misses, and other memory cache attributes. NET Process Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. NET Process workspace This workspace provides an overview of the.net processes running on a managed system. The following graphs are included in the workspace. This workspace contains the following views:.net Processes Details This report displays the.net processes running on a managed system, and the version of CLR loaded into process. Private and Virtual Bytes This bar chart shows the amount of memory consumed by.net processes. Performance Object Status Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. Performance Object Status workspace This workspace displays the overall health of the application. This workspace contains the following view: Data Collection Status Displays the status of the collection of data from the application. Normally this will display NO ERROR indicating that the agent is collecting application data correctly. If some of the agent's other views are empty this view will help isolate the cause of the failure. PerfMon objects will display the object class name. WMI objects will display the name of the object class including the namespace. SHELL_COMMAND objects will display a descriptive name for the collection and NO_RESPONSE_RECEIVED if the script did not return data, OBJECT_NOT_FOUND or OBJECT_NOT_ACTIVE if the process could not be started. CUSTOM objects will display the name of the attribute group. Each CUSTOM group may display error values specific to the data collection. These are documented in the User's Guide. Windows Communication Foundation Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. Service Model Operation workspace This workspace is used by an administrator to obtain the required information related to the Service Model Operation V3.0 and Service Model Operation V4.0.The following reports and graphs are included in the workspace: This workspace contains the following views: Call Details in WCF This plot chart displays information about the number of calls that failed. Security Call Details This bar chart displays the calls that are not authorized and failures that occurred due to validation and authenticaton. Call Details This report gives an administrator detailed information about the calls. 14 The Microsoft.NET Framework agent Reference

23 Service Model Service workspace This workspace is used by an administrator to obtain all the required information related to the Service Model Service V3.0 and Service Model Service V4.0.The following reports and graphs are included in the workspace: This workspace contains the following views: Instances Created This plot chart displays the instances created for the Service Model Service. Transactions in WCF This plot chart displays the information about the transactions for the Service Model Service. Call Details This report gives an administrator detailed information about the calls for the Service Model Service. Reliable Message Details This report gives an administrator detailed information about the reliable messages for the Service Model Service. Transaction Details This report gives an administrator detailed information about the transaction for the Service Model Service. Service Model Svc Host workspace This workspace is used by an administrator to obtain all the required information related to the Service Model Svc Host V3.0 and Service Model Svc Host V4.0. This workspace contains the following views: Registration Details This plot chart displays the information about registrations for the Service Model Svc Host. Service Model Svc Host Details This report displays detailed information about the Service Model Svc Host. Windows Communication Foundation workspace This workspace is used to monitor the transcations and calls related to Service Model Endpoint V3.0 and Service Model Endpoint v4.0 in Windows Communication Foundation.The following reports and graphs are included in the workspace: This workspace contains the following views: Transactions Flowed This plot chart displays the transaction that are flowed to the Service Model Endpoint. Security Calls This bar chart displays the calls that are not authorized and the failures that occurred due to validation and authenticaton. Call Details This report gives an administrator detailed information about the calls for the Service Model Endpoint. Reliable Message Details This report gives an administrator detailed information about the reliable messages for the Service Model endpoint. Windows Workflow Foundation Navigator item The workspace descriptions are organized by the Navigator item to which the workspaces are relevant. Windows Workflow Foundation workspace This workspace provides information about the workflow cycle in Windows Workflow Foundation V3.0 and Windows Workflow Foundation V4.0.The following reports and graphs are included in the workspace: This workspace contains the following views: Chapter 1. Workspaces reference 15

24 Workflow Cycle This plot chart indicates the rate at which workflows change their state at run time. Workflow Details This report lists the performance counters related to the Windows Workflow Foundation. Workflow Service Details This report lists the performance counters related to the Windows Workflow Services. Cross-linked workspaces This section contains cross-links within the Microsoft.NET Framework agent. Table 1 contains source, target, and filtering criteria for the cross-linked workspaces. Table 1. Cross-linked workspaces within the Microsoft.NET Framework agent Link name Service Model Service Service Model Endpoint Source navigator item Windows Communication Foundation Windows Communication Foundation Source workspace name Service Model Endpoint Service Model Service Source view name Call Details, Reliable Message Details Call Details, Reliable Message Details, Transaction Details Target workspace name Service Model Service Service Model Endpoint Filter Service Name Service Name 16 The Microsoft.NET Framework agent Reference

25 Chapter 2. Attributes reference Attributes are the application properties that are being measured and reported by the IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft.NET Framework Agent. About attributes Attributes are organized into attribute groups. Attributes in an attribute group relate to a single object such as an application, or to a single kind of data such as status information. Attributes in a group can be used in queries, query-based views, situations, policy workflows, take action definitions, and launch application definitions. Chart or table views and situations are two examples of how attributes in a group can be used: v Chart or table views Attributes are displayed in chart and table views. The chart and table views use queries to specify which attribute values to request from a monitoring agent. You use the Properties editor to apply filters and set styles to define the content and appearance of a view based on an existing query. v Situations You use attributes to create situations that monitor the state of your operating system, database, or application. A situation describes a condition you want to test. When you start a situation, the values you assign to the situation attributes are compared with the values collected by the Microsoft.NET Framework agent and registers an event if the condition is met. You are alerted to events by indicator icons that are displayed in the Navigator. Additional information about attributes For more information about using attributes and attribute groups, see the Tivoli Enterprise Portal User's Guide. For a list of the attribute groups, a list of the attributes in each attribute group, and descriptions of the attributes for this monitoring agent, see Attribute groups for the monitoring agent and Attributes in each attribute group on page 21. Attribute groups for the monitoring agent The Microsoft.NET Framework agent contains the following attribute groups. The table name depends on the maximum table name limits of the target database being used for the Tivoli Data Warehouse. If the maximum name is 30 characters, any warehouse table name longer than 30 characters is shortened to 30 characters. v Attribute group name: ASP.NET Applications Error Filter Table name: KQFASPNEF2 Warehouse table name: KQF_ASP_NET_APPS_ERROR_FILTER or KQFASPNEF2 v Attribute group name: ASP.NET Applications Filter Table name: KQFASPNETF Warehouse table name: KQF_ASP_NET_APPS_FILTER or KQFASPNETF v Attribute group name: ASP.NET Applications V1.1 Table name: KQFASPNET0 Warehouse table name: KQF_ASP_NET_APPS_V1_1_4322 or KQFASPNET0 v Attribute group name: ASP.NET Applications V2.0 Copyright IBM Corp. 2008,