default-process-configuration.md

Default Process Configuration

Default process configuration is used to determine which process is used for metrics and in situations where the process is not specified in the query to retrieve an artifact. A process must match all the specified filters. If a Key is not specified, the default is ProcessId.

Name	Type	Description
Key	string	Specifies which criteria to match on the process. Can be ProcessId, ProcessName, CommandLine, ManagedEntryPointAssemblyName.
Value	string	The value to match against the process.
MatchType	string	The type of match to perform. Can be Exact or Contains for sub-string matching. Both are case-insensitive.

Optionally, a shorthand format allows you to omit the Key and Value terms and specify your Key/Value pair as a single line.

Name	Type	Description
ProcessId	string	Specifies that the corresponding value is the expected ProcessId.
ProcessName	string	Specifies that the corresponding value is the expected ProcessName.
CommandLine	string	Specifies that the corresponding value is the expected CommandLine.
ManagedEntryPointAssemblyName	string	Specifies that the corresponding value is the expected ManagedEntryPointAssemblyName.

Examples

Match the IISExpress process by name

JSON

{
  "DefaultProcess": {
    "Filters": [{
      "Key": "ProcessName",
      "Value": "iisexpress"
    }]
  },
}

Kubernetes ConfigMap

DefaultProcess__Filters__0__Key: "ProcessName"
DefaultProcess__Filters__0__Value: "iisexpress"

Kubernetes Environment Variables

- name: DotnetMonitor_DefaultProcess__Filters__0__Key
  value: "ProcessName"
- name: DotnetMonitor_DefaultProcess__Filters__0__Value
  value: "iisexpress"

Match the IISExpress process by name (Shorthand)

JSON

{
  "DefaultProcess": {
    "Filters": [{
      "ProcessName": "iisexpress"
    }]
  },
}

Kubernetes ConfigMap

DefaultProcess__Filters__0__ProcessName: "iisexpress"

Kubernetes Environment Variables

- name: DotnetMonitor_DefaultProcess__Filters__0__ProcessName
  value: "iisexpress"

Match pid 1

JSON

{
  "DefaultProcess": {
    "Filters": [{
      "Key": "ProcessId",
      "Value": "1"
    }]
  },
}

Kubernetes ConfigMap

DefaultProcess__Filters__0__Key: "ProcessId"
DefaultProcess__Filters__0__Value: "1"

Kubernetes Environment Variables

- name: DotnetMonitor_DefaultProcess__Filters__0__Key
  value: "ProcessId"
- name: DotnetMonitor_DefaultProcess__Filters__0__Value
  value: "1"

Match pid 1 (Shorthand)

JSON

{
  "DefaultProcess": {
    "Filters": [{
      "ProcessId": "1"
    }]
  },
}

Kubernetes ConfigMap

DefaultProcess__Filters__0__ProcessId: "1"

Kubernetes Environment Variables

- name: DotnetMonitor_DefaultProcess__Filters__0__ProcessId
  value: "1"

Match MyApp.dll Entry Point

JSON

{
  "DefaultProcess": {
    "Filters": [{
      "Key": "ManagedEntryPointAssemblyName",
      "Value": "MyApp"
    }]
  },
}

Kubernetes ConfigMap

DefaultProcess__Filters__0__Key: "ManagedEntryPointAssemblyName"
DefaultProcess__Filters__0__Value: "MyApp"

Kubernetes Environment Variables

- name: DotnetMonitor_DefaultProcess__Filters__0__Key
  value: "ManagedEntryPointAssemblyName"
- name: DotnetMonitor_DefaultProcess__Filters__0__Value
  value: "MyApp"

Match MyApp.dll Entry Point (Shorthand)

JSON

{
  "DefaultProcess": {
    "Filters": [{
      "ManagedEntryPointAssemblyName": "MyApp"
    }]
  },
}

Kubernetes ConfigMap

DefaultProcess__Filters__0__ManagedEntryPointAssemblyName: "MyApp"

Kubernetes Environment Variables

- name: DotnetMonitor_DefaultProcess__Filters__0__ManagedEntryPointAssemblyName
  value: "MyApp"