Discovery Filters


Overview

Applications Manager allows you to discover resources in a monitor type based on various filtering conditions. You can choose to filter resources for discovery based on the regex filters for the particular monitor. It discovers resources that matches the specified regex filter from the server and monitors their performance and availability.

Note: This option is only available in the Docker, VMware ESXi, RabbitMQ, IBM WebSphere MQ and Microsoft Azure monitors.

Syntax

<ModuleType>_<AttributeName>=[Regex]

where,
<ModuleType> - Module type to be monitored.
<AttributeName> - Name of the attribute to be monitored.
[Regex] - Regex value to be specified.

Following are the list of points that are to be noted for entering a valid regex filter:

  • Users can provide multiple filters separated by comma and provide appropriate conditions/symbols such as "||" (OR), "&&" (AND) and "[]" between the filters with different attribute names to create multiple options.
  • Users should not use the characters _ [ ] in the regex value as they are used as a separator and for grouping functionality.
  • Users can provide discovery filter regex for multiple Module Types of the same monitor type. However, they cannot group multiple Module Types in the Discovery Filter regex. Example: CONTAINER_NAME=tomcat.* && NODE_NAME=test.*
  • In case the user provides any invalid module type or an attribute name that is not supported, an error message will be shown during the monitor addition.
  • Attribute names, module names and regex are case-sensitive.

Supported monitor types

Following are the list of monitor types that support discovery filters:

Monitor NameModule Type (Child / Tabular Resources)Attributes Name
Citrix Hypervisor VIRTUALMACHINE NAME
Docker CONTAINER NAME, IMAGE, STATE
Hyper-V VIRTUALMACHINE NAME, STATE
KVM VIRTUALMACHINE NAME, STATE
Oracle VM Virtual Infrastructure VIRTUALMACHINE NAME
RHV Virtual Infrastructure VIRTUALMACHINE NAME, STATE
VMware ESXi / vCenter VIRTUALMACHINE NAME


RabbitMQ
QUEUE NAME, STATE
EXCHANGE NAME, TYPE
CONNECTION STATE
CHANNEL NAME, USER
IBM App connect Enterprise INTEGRATIONSERVER NAME, STATUS



IBM WebSphere MQ
QUEUE NAME
CHANNEL NAME, TYPE, STATUS
LISTENER NAME
SERVICE NAME, TYPE
EXECUTION NAME, STATUS
MESSAGEFLOW NAME, STATUS

























Amazon
AmazonAPIGatewayHTTPAPI
























Name
AmazonAPIGatewayRESTAPI
AmazonAPIGatewayWebSocketAPI
AmazonActiveMQ
AmazonCloudFront
AmazonCloudHSM
AmazonDMSReplicationInstance
AmazonDMSReplicationTask
AmazonDirectConnect
AmazonElasticContainerRegistry
AmazonElasticFileSystem
AmazonFileTransferFamily
AmazonFSxFileCache
AmazonGatewayLoadBalancer
AmazonKeyManagementService
AmazonRabbitMQ
AmazonRoute53HealthChecks
AmazonSecretsManager
AmazonStorageGateway
AmazonStorageGatewayFileShares
AmazonStorageGatewayVolumes
AmazonVpcNatGateway
AmazonWebApplicationFirewall
ApplicationLoadBalancer
DynamoDB
EC2Instance
ElasticBeanStalk
ElasticContainerService
ElasticKubernetesService
Lambda
NetworkLoadBalancer
RDSInstance
S3
SimpleNotificationService
SimpleQueueService

























Microsoft Azure
VirtualMachines
























Name, ResourceGroupName
StorageAccounts
PremiumStorageAccount
SQLDatabases
ServiceBus
KubernetesServices
SQLManagedInstance
LoadBalancer
AzurePostgreSQLServer
AzureAppService
AzureSynapseAnalytics
AzureFunctions
AzureVirtualNetwork
AzureVMScaleSets
AzureRedisCache
AzureCosmosDB
AzureMariaDBServer
AzureMySQLServer
AzureNetworkInterface
AzureExpressRouteCircuit
AzurePublicIPAddress
AzureVNetGateway
AzureApplicationGateway
AzureDNSZone
AzurePrivateDNSZone
AzureFirewall
AzureTrafficManagerProfile
AzureConnection
AzureNetworkWatcherConnection
AzureFrontDoorAndCDNProfile
AzureAppPlan
AzureContainerInstance
AzureContainerRegistry
AzureSQLElasticPool
AzureLogicAppStandard
AzureLogicAppConsumption
AzureEventHubNamespace
AzureEventHubCluster
AzureStorageSyncService
AzureKeyVaults
AzureKeyVaultManagedHSM
AzureContainerApp
AzureRelay
AzureBastion
AzurePrivateEndpoint
AzurePrivateLinkService
AzureBackupVault
AzureRecoveryServiceVault

Examples

Following are some examples by which regex filters can be specified:

S.No.Monitor NameDiscovery RegexBehavior
1 Docker CONTAINER_NAME=tomcat.* Discovers all the containers starting with the name 'tomcat'.
2 Docker CONTAINER_NAME=tomcat.*, NODE_NAME=test.* Discovers all the containers starting with the name 'tomcat' and node name starting with 'test'.
3 Docker CONTAINER_NAME=tomcat.* && CONTAINER_IMAGE=tomcat8.* Discovers the container starting with the name 'tomcat' and image starting with 'tomcat8'.
4 Docker CONTAINER_NAME=tomcat.* || CONTAINER_IMAGE=tomcat8.* Discovers the container starting with the name 'tomcat' or the image starting with 'tomcat8'.
5 Docker CONTAINER_NAME=tomcat.* && [CONTAINER_IMAGE=tomcat8.* || CONTAINER_PATH=cont1.*] Discovers the container starting with the name 'tomcat' if container image starts with 'tomcat8' or the path starts with 'cont1'.
6 Docker CONTAINER_NAME=tomcat.* , [CONTAINER_IMAGE=tomcat8.* || CONTAINER_PATH=cont1.*] Discovers all the container starting with name 'tomcat' and the container whose image starts with 'tomcat8' or the path start with 'cont1'.
7 Docker CONTAINER_NAME=tomcat.* && CONTAINER_STATE=running.* Discovers the container starting with the name 'tomcat' and is in 'running' state.
8 Docker CONTAINER_NAME=tomcat.* || CONTAINER_STATE=exited.* Discovers the container starting with the name 'tomcat' or is in 'exited' state.
9 Microsoft Azure VirtualMachines_Name=cloud.* && VirtualMachines_ResourceGroupName=apm.* Discovers all the Virtual Machines whose names start with 'cloud' under the resource groups whose names start with 'apm'.
10 Microsoft Azure StorageAccounts_Name=^(?!prod).* && StorageAccounts_ResourceGroupName=^(?!prod).* Discovers all Storage Accounts having name not starting with 'prod' under the resource group having a name not starting with 'prod'.
11 Microsoft Azure SQLDatabases_Name=(^(Apm|Cloud).*$) || SQLDatabases_ResourceGroupName=DB.* Discovers all the SQL Databases having a name starting with either 'Apm' or 'Cloud' and will also discover all the SQL Databases under the resource group having a name starting with DB.
12 Microsoft Azure ServiceBus_Name=APM.* || ServiceBus_NAME=.*APM Discovers all Service Bus namespaces having a name that starts or ends with APM.
13 Microsoft Azure KubernetesServices_ResourceGroupName=Cloud.*APM, SQLManagedInstance_Name=MI.*, LoadBalancer_NAME=.*alb.* Discovers all the Kubernetes clusters under the resource group having a name starting with 'Cloud' and ending with 'APM', all the SQL Managed Instances having a name starting with 'MI', and the Load Balancer names containing 'alb'.
14 Amazon EC2Instance_Name=^prod-[0-9]+$, S3_Name=backup[0-9]{2}, Lambda_Name=^(?!test).+ Discovers EC2 instances named exactly in the format prod- followed by one or more digits, S3 buckets ending with exactly two digits after backup, and all Lambda functions whose names do not start with test.
15 Amazon AmazonCloudFront_Name=cf-.-edge, AmazonWebApplicationFirewall_Name=waf-., AmazonFSxFileCache_Name=.*cache Discovers CloudFront distributions with names starting with cf- and containing -edge, WAFs starting with waf-, and FSx File Caches with names ending in cache.
16 Amazon AmazonDMSReplicationTask_Name=task-[a-z]{3}, AmazonKeyManagementService_Name=^key-[A-Z]+$, AmazonSecretsManager_Name=^sec[0-9]{4} Discovers DMS tasks with names starting with task- followed by exactly three lowercase letters, KMS names starting with key- followed by one or more uppercase letters, and Secrets Manager secrets starting with sec followed by exactly four digits.

Thank you for your feedback!

Was this content helpful?

We are sorry. Help us improve this page.

How can we improve this page?
Do you need assistance with this topic?
By clicking "Submit", you agree to processing of personal data according to the Privacy Policy.