Skip to end of metadata
Go to start of metadata

This topic describes the conventions that the App Agent for .NET uses to automatically name nodes.

Node Naming Syntax

Node naming relies on the application name to directly link nodes to an application. This naming convention clarifies node names for applications in an application pool hosting multiple applications and node names for applications in a recycle process.

(info) If you are upgrading to 3.8 from the App Agent for .NET version 3.7.7 or earlier, the new node naming convention takes effect upon restart. Nodes named under the old scheme become historical nodes with no correlation to the new nodes.

Syntax for IIS Nodes

The naming pattern for IIS nodes is as follows:

<machine-name>-<tier>-<site>/<app>
  • We omit <app> when the application is the default site root application.
  • We omit <tier> when the tier name is the same as the site name.

For example:

WIN-86M7CEJO6P5-Order Server-OrderSvc
  • WIN-86M7CEJO6P5 is the machine name.
  • Order Server is the tier name.
  • OrderSvc is the site name. The application is the default app in the site root, so we omit it.

    (info) Different .NET versions of the same application have their own versions of the CLR and run on independent processes. Therefore they will show up as different nodes.

Machine Name

Machine name is the NetBIOS name of the local computer where the application runs.

Tier

Tier is the name of the logical tier for the application. See Logical Model.

Site/App

Site is the IIS Site name.
App is the virtual path within the site.

For example:

WIN-86M7CEJO6P5-Order Server-Store/ProcessOrder
  • Store is the IIS Site name.
  • ProcessOrder is the application name within the site.

Syntax for IIS Web Garden Nodes

The syntax for web gardens is the same as IIS Nodes, except that we append a process index to differentiate between the worker processes in the web garden.

<machine-name>-<tier>-<site>/<app>-<process-index>

Process Index

The process index represents the zero-based index of the process. For a web garden-IIS-hosted application with five worker processes, the index could be 0, 1, 2, 3 or 4.

(warning) Don't confuse the process index with the Windows process id.

When IIS first launches web garden processes, the agent assigns a sequential index to each process. However, as IIS recycles processes, the agent reuses the available indexes freed by terminated processes. This means there will likely be no correlation between the index sequence and the chronological start of the process.

There are edge cases where you may see more nodes than the maximum number of worker processes. This can happen when a long-running request prevents a process from shutting down before its replacement launches.

Syntax for Windows Service Nodes

The naming pattern for Windows service nodes is as follows:

<machine-name>-<tier>-<service-name>
  • We omit <tier> when the tier name is the same as the service name.

Machine Name

Machine name is the NetBIOS name of the local computer where the Windows service runs.

Service Name

Service name is the same as Service name in the service properties window.

For Example:

WIN-86M7CEJO6P5-MyWindowsService
  • WIN-86M7CEJO6P5 is the machine name.
  • MyWindowsService is the Service name.

Syntax for Standalone Application Nodes

The naming pattern for standalone applications is as follows:

<machine-name>-<tier>-<executable-name>
  • We omit <tier> when the tier name is the same as the executable name.

Machine Name

Machine name is the NetBIOS name of the local computer where the standalone application runs.

Executable Name

Executable name is the standalone application executable file name.

For Example:

WIN-86M7CEJO6P5-MyStandaloneApp.exe
  • WIN-86M7CEJO6P5 is the machine name.
  • MyStandaloneApp.exe is the executable file name.

Maximum Number of Nodes Generated

Below is the algorithm for calculating how many nodes will be generated. It refers to all nodes that are alive, as historical node counts can change via retention and deletion time frames as well as manual deletion, etc.

IISApp1_AppPool_MaxWorkerProcesses
+
IISApp2_AppPool_MaxWorkerProcesses
+...
IISAppN_AppPool_MaxWorkerProcesses
+...
Self-Hosted Process (Windows Service, Console Application, etc)
=
Number of Nodes

(info) In the case of a webgarden, by default AppDynamics flags a node as historical within five minutes after it recycles. Wait 5 minutes for a recycled node to disappear from the application flow map.