From 81498723a0b71c24c5dfe73fbcb1fc2939df85e6 Mon Sep 17 00:00:00 2001 From: MikeTschudi Date: Thu, 3 Dec 2015 12:10:56 -0800 Subject: [PATCH 1/3] Added to logging documentation --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 75999efa..4c9915a9 100644 --- a/README.md +++ b/README.md @@ -50,7 +50,8 @@ All three proxies respect the XML configuration properties listed below. * Use the ProxyConfig tag to specify the following proxy level settings. * **mustMatch="true"** : When true only the sites listed using serverUrl will be proxied. Set to false to proxy any site, which can be useful in testing. However, we recommend setting it to "true" for production sites. * **allowedReferers="http://server.com/app1,http://server.com/app2"** : A comma-separated list of referer URLs. Only requests coming from referers in the list will be proxied. See https://github.com/Esri/resource-proxy/issues/282 for detailed usage. - * **logFile="proxylog.txt"** : When a logFile is specified, the proxy will log messages to this file. + * **logFile="proxylog.txt"** : When a logFile is specified, the proxy will log messages to this file. If only a filename is supplied for the logFile, the proxy uses the folder where the proxy.config file is found. *N.B.: The folder containing the logFile must be writable by the web server.* + * **logLevel="Error"** : An optional flag indicating the level of detail to write; available levels are "Error", "Warning", "Info", or "Verbose" in order from fewest to most messages; the default is "Error". * Add a new `` entry for each service that will use the proxy. The proxy.config allows you to use the serverUrl tag to specify one or more ArcGIS Server services that the proxy will forward requests to. The serverUrl tag has the following attributes: * **url**: Location of the ArcGIS Server service (or other URL) to proxy. Specify either the specific URL or the root (in which case you should set matchAll="false"). * **matchAll="true"**: When true all requests that begin with the specified URL are forwarded. Otherwise, the URL requested must match exactly. From 00e71bb5db185f4b0c2e791009ed135e504a3594 Mon Sep 17 00:00:00 2001 From: MikeTschudi Date: Fri, 4 Dec 2015 07:08:49 -0800 Subject: [PATCH 2/3] Updated logLevel to show each of the three language variations --- README.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 4c9915a9..b3054fe9 100644 --- a/README.md +++ b/README.md @@ -51,7 +51,10 @@ All three proxies respect the XML configuration properties listed below. * **mustMatch="true"** : When true only the sites listed using serverUrl will be proxied. Set to false to proxy any site, which can be useful in testing. However, we recommend setting it to "true" for production sites. * **allowedReferers="http://server.com/app1,http://server.com/app2"** : A comma-separated list of referer URLs. Only requests coming from referers in the list will be proxied. See https://github.com/Esri/resource-proxy/issues/282 for detailed usage. * **logFile="proxylog.txt"** : When a logFile is specified, the proxy will log messages to this file. If only a filename is supplied for the logFile, the proxy uses the folder where the proxy.config file is found. *N.B.: The folder containing the logFile must be writable by the web server.* - * **logLevel="Error"** : An optional flag indicating the level of detail to write; available levels are "Error", "Warning", "Info", or "Verbose" in order from fewest to most messages; the default is "Error". + * **logLevel="Error"** : An optional flag indicating the level of detail to write to the logFile. Flags for each of the various languages are listed below. + * .Net levels are "Error", "Warning", "Info", and "Verbose" in order from fewest to most messages; the default is "Error". + * Java levels are "SEVERE", "WARNING", "INFO", "CONFIG", "FINE", "FINER", and "FINEST" in order from fewest to most messages; the default is "SEVERE". + * PHP levels are 0 (writes messages and errors to logs), 1 (shows proxy errors and messages in browser console), 2 (combination of levels 0 and 1), and 3 (no logging); the default is 0. * Add a new `` entry for each service that will use the proxy. The proxy.config allows you to use the serverUrl tag to specify one or more ArcGIS Server services that the proxy will forward requests to. The serverUrl tag has the following attributes: * **url**: Location of the ArcGIS Server service (or other URL) to proxy. Specify either the specific URL or the root (in which case you should set matchAll="false"). * **matchAll="true"**: When true all requests that begin with the specified URL are forwarded. Otherwise, the URL requested must match exactly. From ac69bab582327b310e9e1cb27389f131b4803fd9 Mon Sep 17 00:00:00 2001 From: MikeTschudi Date: Fri, 4 Dec 2015 07:53:36 -0800 Subject: [PATCH 3/3] Clarified that logFile default path behavior is for .Net --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index b3054fe9..f3af1b32 100644 --- a/README.md +++ b/README.md @@ -50,7 +50,7 @@ All three proxies respect the XML configuration properties listed below. * Use the ProxyConfig tag to specify the following proxy level settings. * **mustMatch="true"** : When true only the sites listed using serverUrl will be proxied. Set to false to proxy any site, which can be useful in testing. However, we recommend setting it to "true" for production sites. * **allowedReferers="http://server.com/app1,http://server.com/app2"** : A comma-separated list of referer URLs. Only requests coming from referers in the list will be proxied. See https://github.com/Esri/resource-proxy/issues/282 for detailed usage. - * **logFile="proxylog.txt"** : When a logFile is specified, the proxy will log messages to this file. If only a filename is supplied for the logFile, the proxy uses the folder where the proxy.config file is found. *N.B.: The folder containing the logFile must be writable by the web server.* + * **logFile="proxylog.txt"** : When a logFile is specified, the proxy will log messages to this file. *N.B.: The folder containing the logFile must be writable by the web server.* If a path is not specified, the .Net proxy uses the folder where the proxy.config file is found. (The Java proxy uses java.util.logging.FileHandler to open the file; the PHP proxy uses fopen to open the file.) * **logLevel="Error"** : An optional flag indicating the level of detail to write to the logFile. Flags for each of the various languages are listed below. * .Net levels are "Error", "Warning", "Info", and "Verbose" in order from fewest to most messages; the default is "Error". * Java levels are "SEVERE", "WARNING", "INFO", "CONFIG", "FINE", "FINER", and "FINEST" in order from fewest to most messages; the default is "SEVERE".