Skip to content

URL patterns

Creating a Watcher consists of providing a series of URLs that are part of the application you want to monitor. The URLs should comply with the following format: <scheme>://<host>[:port][</path>].

Scheme

It must be one of those values: “http”, “https”, “ws”, “wss” or wildcard(*) to target all schemes.

Host

It may subsequently contain any combination of ascii(7) letters (from a to z or uppercase), digits, hyphen(-), dot(.) or wildcard(*). IPv6 is also supported. In this case, the IP address should be embraced with brackets (e.g. : [fe80::7d15:f81e:c9c7:d2d9]).

Port

This field is optional. If it is undefined, it matches standard ports (http:80, https:443, ws:80 and wss:443). If defined, it must start with a :, contain a number or a wildard(*) and shouldn’t be empty.

Path

This field is optional. If it is empty or undefined, then it is considered as a wildcard. It must start with a /. It may then subsequently contain any combination of the wildcard(*) and any of the characters that are allowed in URL paths (no ? or #). Multiple consecutives / will be simplified to one. The value for the path matches against the string which is the URL path without the URL query string (?) or even fragments (#).

Notes

Literal * in path is not supported and will be treated as a wildcard(*).

Pattern only supports ascii(7), i.e. word puny codes should be used for UTF8 characters. For example, www.café.fr/* is not supported and must be replaced by www.xn--caf--dma.fr/*.

The interpretation of the encoded URL (based on %) is product related. Hence any encoded URL will be treated as a regular string and no decoding will be made. For example, https://contoso.com/test/* will not match https://contoso.com/t%65st.

Examples of URL patterns

URL Pattern Examples of matches Examples of non-matches
*://*:*
*://*:*/*
http://kadiska.com:9888
https://kadiska.com/foo
ws://contoso.com:9777/foo
wss://contoso.com:8080/foo?a=5#tag
file://contoso.com
ftp://contoso.com
*://*
*://*/*
http://kadiska.com
http://kadiska.com:80
http://kadiska.com:80/foo
http://kadiska.com/foo?a=5#tag

https://kadiska.com
https://kadiska.com:443
https://kadiska.com:443/foo
https://kadiska.com/foo?a=5#tag

wss://contoso.com
wss://contoso.com:443/
wss://contoso.com:443/foo
wss://contoso.com/foo?a=5#tag
http://kadiska.com:443
https://kadiska.com:80
wss://contoso.com:8080/foo
*://contoso.com:80/path http://contoso.com/path
http://contoso.com:80/path
https://contoso.com:80/path
http://contoso.com:443/path
https://contoso.com/path
*://contoso.com
*://contoso.com/
*://contoso.com/*
http://contoso.com
http://contoso.com/
https://contoso.com/foo
https://contoso.com/foo?a=5#tag
http://other.com
http://contoso.com:8080
https://contoso.com:80
*://192.168.0.1:* http://192.168.0.1/foo?a=5#tag
http://192.168.0.1:798/foo?a=5#tag
http://192.168.0.2/foo?a=5#tag
*://[fe80::7d15:f81e:c9c7:d2d9] http://[fe80::7d15:f81e:c9c7:d2d9]/foo?a=5#tag
http://[fe80::7d15:f81e:c9c7:d2d9]:80/foo?a=5#tag
http://[fe81::7d15:f81e:c9c7:d2d9]
*://*contoso*
*://*contoso*/
*://*contoso*/*
http://contoso.com/foo
http://contoso.mail.com/foo
https://acontosoy.com/foo
http://contosi.com
*://*.contoso.* http://mail.contoso.com/foo
https://smtp.contoso.other.com/foo
http://contoso.com
https://*/path https://contoso.com/path
https://a.contoso.com/path
https://other.com/path
https://mozilla.com/path?foo=1
http://contoso.com/path
https://contoso.com/path/
https://contoso.com/a
https://contoso.com/
https://*/path/ https://contoso.com/path/
https://a.contoso.com/path/
https://something.com/path/
https://contoso.com/path/?foo=1
http://contoso.com/path/
https://contoso.com/path
https://contoso.com/a
https://contoso.com/
https://bar/test/foo https://bar/test/foo
https://bar///test////foo
https://bar/t%65st/foo
https://bar///t%65st///foo
https://bar/t%65st/foo https://bar/t%65st/foo
https://bar///t%65st///foo
https://bar/test/foo
https://bar///test////foo
´https://hh//b//` https://hh/a/b/c/
https://hh/d/b/f/
https://hh/a/b/c/d/
https://hh/a/b/c/d/#section1
https://hh/a/b/c/d/?foo=/
https://hh/a/b/c/d/?foo=bar
https://hh/b/c/
https://hh/a/b/
https://hh/a?foo=21314&bar=/b/&extra=c/

© 2022 Kadiska | Digital Experience Monitoring DEM. All rights reserved