Skip to content
This repository has been archived by the owner on May 6, 2024. It is now read-only.

Added section about ingress/egress metrics in log paths #114

Open
wants to merge 1 commit into
base: develop
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions Content/Guides/syslog-ng-guide-admin/logpath.htm
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,35 @@ <h6>Declaration</h6>
</table>
<MadCap:snippetBlock src="../shared/wnt/note-element-order.htm">
</MadCap:snippetBlock>
<p>In <MadCap:variable name="General.abbrev"></MadCap:variable> version 4.1 and later versions, it is possible to add an ID or name to the log path to produce an easily readable configuration file. <MadCap:variable name="General.abbrev"></MadCap:variable> also collects ingress and egress metrics for named log paths.</p>
<div class="Example">
<h6 name="ingress-egress-example"><a name="ingress-egress-example"></a>Example:</h6>
<pre>log top-level {
source(s_local);

log inner-1 {
filter(f_inner_1);
destination(d_local_1);
};

log inner-2 {
filter(f_inner_2);
destination(d_local_2);
};
};</pre>
</div>
<p>Each named log path counts its ingress and egress messages:</p>
<pre>syslogng_log_path_ingress{id="top-level"} 114
syslogng_log_path_ingress{id="inner-1"} 114
syslogng_log_path_ingress{id="inner-2"} 114
syslogng_log_path_egress{id="top-level"} 103
syslogng_log_path_egress{id="inner-1"} 62
syslogng_log_path_egress{id="inner-2"} 41
</pre>
<div class="Note">
<p class="Hyphenation"><span class="AllNoteStyles">NOTE: </span>The egress statistics only log the messages which have not been filtered out from the related log path. It ignores whether there are any destinations in the message or that any destination delivers or drops the message.</p>
</div>

<div class="Example">
<h6 name="log-statement-example"><a name="log-statement-example"></a>Example: A simple log statement</h6>
<MadCap:snippetBlock src="../shared/chunk/log-statement.htm">
Expand Down