Clarifies how logging overrides work.

This commit is contained in:
Tom Keffer
2022-03-04 08:17:56 -08:00
parent 7a210b2817
commit e0bb6b3dc1
2 changed files with 76 additions and 39 deletions

View File

@@ -1669,7 +1669,7 @@ longitude = -77.0366</pre>
or <a href="http://www.wxqa.com/">CWOP</a>.
</p>
<p class="config_important">log_success</p>
<p class="config_option">log_success</p>
<p>
If you set a value for <span class="code">log_success</span> here, it will override the value set at the <a
href="#global_log_success">top-level</a> and will apply only to RESTful services. In addition, <span
@@ -1677,7 +1677,7 @@ longitude = -77.0366</pre>
subsection (<i>e.g.,</i> <span class="code">[[CWOP]]</span>).
</p>
<p class="config_important">log_failure</p>
<p class="config_option">log_failure</p>
<p>
If you set a value for <span class="code">log_failure</span> here, it will override the value set at the <a
href="#global_log_failure">top-level</a> and will apply only to RESTful services. In addition, <span
@@ -1733,11 +1733,16 @@ longitude = -77.0366</pre>
<p class='config_option'>log_success</p>
<p>In case of success, make a note in the system log. The default is <span class='code'>True</span>.</p>
<p>
If you set a value here, it will apply only to the station registry.
</p>
<p class='config_option'>log_failure</p>
<p>In case of failure, make a note in the system log. The default is <span class='code'>True</span>.</p>
<p>
If you set a value here, it will apply only to the station registry.
</p>
<h3 class="config_section">[[AWEKAS]]</h3>
@@ -1771,11 +1776,15 @@ longitude = -77.0366</pre>
<p class='config_option'>log_success</p>
<p>In case of success, make a note in the system log. The default is <span class='code'>True</span>.</p>
<p>
If you set a value here, it will apply only to logging for AWEKAS.
</p>
<p class='config_option'>log_failure</p>
<p>In case of failure, make a note in the system log. The default is <span class='code'>True</span>.</p>
<p>
If you set a value here, it will apply only to logging for AWEKAS.
</p>
<p class='config_option'>retry_login</p>
@@ -1844,11 +1853,16 @@ longitude = -77.0366</pre>
<p class='config_option'>log_success</p>
<p>In case of success, make a note in the system log. The default is <span class='code'>True</span>.</p>
<p>
If you set a value here, it will apply only to logging for CWOP.
</p>
<p class='config_option'>log_failure</p>
<p>In case of failure, make a note in the system log. The default is <span class='code'>True</span>.</p>
<p>
If you set a value here, it will apply only to logging for CWOP.
</p>
<h3 class="config_section">[[PWSweather]]</h3>
@@ -1879,11 +1893,15 @@ longitude = -77.0366</pre>
<p class='config_option'>log_success</p>
<p>In case of success, make a note in the system log. The default is <span class='code'>True</span>.</p>
<p>
If you set a value here, it will apply only to logging for PWSweather.
</p>
<p class='config_option'>log_failure</p>
<p>In case of failure, make a note in the system log. The default is <span class='code'>True</span>.</p>
<p>
If you set a value here, it will apply only to logging for PWSweather.
</p>
<p class='config_option'>retry_login</p>
@@ -1931,11 +1949,15 @@ longitude = -77.0366</pre>
<p class='config_option'>log_success</p>
<p>In case of success, make a note in the system log. The default is <span class='code'>True</span>.</p>
<p>
If you set a value here, it will apply only to logging for WOW.
</p>
<p class='config_option'>log_failure</p>
<p>In case of failure, make a note in the system log. The default is <span class='code'>True</span>.</p>
<p>
If you set a value here, it will apply only to logging for WOW.
</p>
<p class='config_option'>retry_login</p>
@@ -2019,15 +2041,14 @@ longitude = -77.0366</pre>
</p>
<p class='config_option'>log_success</p>
<p>In case of success, make a note in the system log. The default is <span class='code'>False</span> for
Rapidfire mode, <span class='code'>True</span> for PWS mode.
<p>
If you set a value here, it will apply only to logging for the Weather Underground.
</p>
<p class='config_option'>log_failure</p>
<p>In case of failure, make a note in the system log. The default is <span class='code'>False</span> for
Rapidfire mode, <span class='code'>True</span> for PWS mode.
<p>
If you set a value here, it will apply only to logging for the Weather Underground.
</p>
<p class='config_option'>retry_login</p>
@@ -2126,6 +2147,22 @@ longitude = -77.0366</pre>
class="symcode">WEEWX_ROOT</span>. Generated files and images will be put here.
</p>
<p class="config_option">log_success</p>
<p>
If you set a value for <span class="code">log_success</span> here, it will override the value set at the <a
href="#global_log_success">top-level</a> and will apply only to reporting. In addition, <span
class="code">log_success</span> can be set for individual reports by putting them under the appropriate
subsection (<i>e.g.,</i> <span class="code">[[Seasons]]</span>).
</p>
<p class="config_option">log_failure</p>
<p>
If you set a value for <span class="code">log_failure</span> here, it will override the value set at the <a
href="#global_log_failure">top-level</a> and will apply only to reporting. In addition, <span
class="code">log_failure</span> can be set for individual reports by putting them under the appropriate
subsection (<i>e.g.,</i> <span class="code">[[Seasons]]</span>).
</p>
<p class="config_option">data_binding</p>
<p>
@@ -2816,22 +2853,22 @@ longitude = -77.0366</pre>
class="code">True</span>.
</p>
<p class="config_option">data_binding</p>
<p>The data binding to be used to store the data. This should match one of the bindings in the <span
class="code">[DataBindings]</span> section, below. Optional. Default is <span class="code">wx_binding</span>.
</p>
<p class="config_option">log_success</p>
<p>
Set to <span class="code">True</span> to log successful insertions into the database. Otherwise,
<span class="code">False</span>. Default is <span class="code">True</span>.
If you set a value for <span class="code">log_success</span> here, it will override the value set at the <a
href="#global_log_success">top-level</a> and will apply only to archiving operations.
</p>
<p class="config_option">log_failure</p>
<p>
Set to <span class="code">True</span> to log unsuccessful insertions into the database. Otherwise,
<span class="code">False</span>. Default is <span class="code">True</span>.
If you set a value for <span class="code">log_failure</span> here, it will override the value set at the <a
href="#global_log_failure">top-level</a> and will apply only to archiving operations.
</p>
<p class="config_option">data_binding</p>
<p>The data binding to be used to store the data. This should match one of the bindings in the <span
class="code">[DataBindings]</span> section, below. Optional. Default is <span class="code">wx_binding</span>.
</p>
<h2 class="config_section">[StdTimeSynch]</h2>

View File

@@ -64,6 +64,10 @@ version = 4.7.0
[StdRESTful]
# Uncomment and change to override logging for uploading services.
# log_success = True
# log_failure = True
[[StationRegistry]]
# To register this weather station with weewx, set this to true,
# then fill out option 'station_url' above.
@@ -138,15 +142,13 @@ version = 4.7.0
# Where the generated reports should go, relative to WEEWX_ROOT
HTML_ROOT = public_html
# Uncomment and change to override logging for reports
# log_success = True
# log_failure = True
# The database binding indicates which data should be used in reports.
data_binding = wx_binding
# Whether to log a successful operation
log_success = True
# Whether to log an unsuccessful operation
log_failure = True
# Each of the following subsections defines a report that will be run.
# See the customizing guide to change the units, plot types and line
# colors, modify the fonts, display additional sensor data, and other
@@ -408,15 +410,13 @@ version = 4.7.0
# Whether to include LOOP data in hi/low statistics
loop_hilo = True
# Uncomment and change to override logging for archive operations
# log_success = True
# log_failure = True
# The data binding used to save archive records
data_binding = wx_binding
# Whether to log successful archive operations
log_success = True
# Whether to log unsuccessful archive operations
log_failure = True
##############################################################################
# This section binds a data store to a database.