@@ -184,6 +184,11 @@ <h1 class="toc-title">Contents</h1>
184184< li > < a href ="#metrics_manage_selinux-false "
185185id ="toc-metrics_manage_selinux-false "> metrics_manage_selinux:
186186false</ a > </ li >
187+ < li > < a href ="#metrics_optional_domains- "
188+ id ="toc-metrics_optional_domains- "> metrics_optional_domains: []</ a > </ li >
189+ < li > < a href ="#metrics_optional_packages- "
190+ id ="toc-metrics_optional_packages- "> metrics_optional_packages:
191+ []</ a > </ li >
187192</ ul > </ li >
188193< li > < a href ="#example-playbook " id ="toc-example-playbook "> Example
189194Playbook</ a > </ li >
@@ -315,43 +320,57 @@ <h2 id="metrics_manage_selinux-false">metrics_manage_selinux: false</h2>
315320< em > adding</ em > policy. It cannot be used for < em > removing</ em > policy.
316321If you want to remove policy, you will need to use the selinux system
317322role directly.</ p >
323+ < h2 id ="metrics_optional_domains- "> metrics_optional_domains: []</ h2 >
324+ < p > List of optional metrics domains to enable. The role will enable the
325+ domains for components you are managing. For example, if you use
326+ < code > metrics_from_elasticsearch: true</ code > , the role will enable the
327+ elasticsearch domain automatically. This variable is for additional
328+ domains.</ p >
329+ < div class ="sourceCode " id ="cb3 "> < pre
330+ class ="sourceCode yaml "> < code class ="sourceCode yaml "> < span id ="cb3-1 "> < a href ="#cb3-1 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="fu "> metrics_optional_domains</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="kw "> [</ span > < span class ="at "> apache</ span > < span class ="kw "> ]</ span > </ span > </ code > </ pre > </ div >
331+ < h2 id ="metrics_optional_packages- "> metrics_optional_packages: []</ h2 >
332+ < p > Additional metrics packages that should be installed, beyond the
333+ default set, to enable additional metrics, export to alternate data
334+ sinks, and so on.</ p >
335+ < div class ="sourceCode " id ="cb4 "> < pre
336+ class ="sourceCode yaml "> < code class ="sourceCode yaml "> < span id ="cb4-1 "> < a href ="#cb4-1 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="fu "> metrics_optional_packages</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="kw "> [</ span > < span class ="at "> pcp-pmda-apache</ span > < span class ="kw "> ]</ span > </ span > </ code > </ pre > </ div >
318337< h1 id ="example-playbook "> Example Playbook</ h1 >
319338< p > Basic metric recording setup for each managed host only, with one
320339weeks worth of data retained before culling.</ p >
321- < div class ="sourceCode " id ="cb3 "> < pre
322- class ="sourceCode yaml "> < code class ="sourceCode yaml "> < span id ="cb3 -1 "> < a href ="#cb3 -1 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="pp "> ---</ span > </ span >
323- < span id ="cb3 -2 "> < a href ="#cb3 -2 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="kw "> -</ span > < span class ="at "> </ span > < span class ="fu "> name</ span > < span class ="kw "> :</ span > < span class ="at "> Manage metrics service</ span > </ span >
324- < span id ="cb3 -3 "> < a href ="#cb3 -3 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> hosts</ span > < span class ="kw "> :</ span > < span class ="at "> all</ span > </ span >
325- < span id ="cb3 -4 "> < a href ="#cb3 -4 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> vars</ span > < span class ="kw "> :</ span > </ span >
326- < span id ="cb3 -5 "> < a href ="#cb3 -5 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> metrics_retention_days</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="dv "> 7</ span > </ span >
327- < span id ="cb3 -6 "> < a href ="#cb3 -6 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> roles</ span > < span class ="kw "> :</ span > </ span >
328- < span id ="cb3 -7 "> < a href ="#cb3 -7 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="kw "> -</ span > < span class ="at "> linux-system-roles.metrics</ span > </ span > </ code > </ pre > </ div >
340+ < div class ="sourceCode " id ="cb5 "> < pre
341+ class ="sourceCode yaml "> < code class ="sourceCode yaml "> < span id ="cb5 -1 "> < a href ="#cb5 -1 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="pp "> ---</ span > </ span >
342+ < span id ="cb5 -2 "> < a href ="#cb5 -2 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="kw "> -</ span > < span class ="at "> </ span > < span class ="fu "> name</ span > < span class ="kw "> :</ span > < span class ="at "> Manage metrics service</ span > </ span >
343+ < span id ="cb5 -3 "> < a href ="#cb5 -3 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> hosts</ span > < span class ="kw "> :</ span > < span class ="at "> all</ span > </ span >
344+ < span id ="cb5 -4 "> < a href ="#cb5 -4 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> vars</ span > < span class ="kw "> :</ span > </ span >
345+ < span id ="cb5 -5 "> < a href ="#cb5 -5 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> metrics_retention_days</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="dv "> 7</ span > </ span >
346+ < span id ="cb5 -6 "> < a href ="#cb5 -6 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> roles</ span > < span class ="kw "> :</ span > </ span >
347+ < span id ="cb5 -7 "> < a href ="#cb5 -7 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="kw "> -</ span > < span class ="at "> linux-system-roles.metrics</ span > </ span > </ code > </ pre > </ div >
329348< p > Scalable metric recording, analysis and visualization setup for the
330349managed hosts, providing a REST API server with an OpenMetrics endpoint,
331350graphs and scalable querying.</ p >
332- < div class ="sourceCode " id ="cb4 "> < pre
333- class ="sourceCode yaml "> < code class ="sourceCode yaml "> < span id ="cb4 -1 "> < a href ="#cb4 -1 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="pp "> ---</ span > </ span >
334- < span id ="cb4 -2 "> < a href ="#cb4 -2 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="kw "> -</ span > < span class ="at "> </ span > < span class ="fu "> name</ span > < span class ="kw "> :</ span > < span class ="at "> Manage metrics with graph and query services</ span > </ span >
335- < span id ="cb4 -3 "> < a href ="#cb4 -3 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> hosts</ span > < span class ="kw "> :</ span > < span class ="at "> all</ span > </ span >
336- < span id ="cb4 -4 "> < a href ="#cb4 -4 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> vars</ span > < span class ="kw "> :</ span > </ span >
337- < span id ="cb4 -5 "> < a href ="#cb4 -5 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> metrics_graph_service</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="ch "> true</ span > </ span >
338- < span id ="cb4 -6 "> < a href ="#cb4 -6 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> metrics_query_service</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="ch "> true</ span > </ span >
339- < span id ="cb4 -7 "> < a href ="#cb4 -7 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> roles</ span > < span class ="kw "> :</ span > </ span >
340- < span id ="cb4 -8 "> < a href ="#cb4 -8 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="kw "> -</ span > < span class ="at "> linux-system-roles.metrics</ span > </ span > </ code > </ pre > </ div >
351+ < div class ="sourceCode " id ="cb6 "> < pre
352+ class ="sourceCode yaml "> < code class ="sourceCode yaml "> < span id ="cb6 -1 "> < a href ="#cb6 -1 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="pp "> ---</ span > </ span >
353+ < span id ="cb6 -2 "> < a href ="#cb6 -2 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="kw "> -</ span > < span class ="at "> </ span > < span class ="fu "> name</ span > < span class ="kw "> :</ span > < span class ="at "> Manage metrics with graph and query services</ span > </ span >
354+ < span id ="cb6 -3 "> < a href ="#cb6 -3 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> hosts</ span > < span class ="kw "> :</ span > < span class ="at "> all</ span > </ span >
355+ < span id ="cb6 -4 "> < a href ="#cb6 -4 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> vars</ span > < span class ="kw "> :</ span > </ span >
356+ < span id ="cb6 -5 "> < a href ="#cb6 -5 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> metrics_graph_service</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="ch "> true</ span > </ span >
357+ < span id ="cb6 -6 "> < a href ="#cb6 -6 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> metrics_query_service</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="ch "> true</ span > </ span >
358+ < span id ="cb6 -7 "> < a href ="#cb6 -7 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> roles</ span > < span class ="kw "> :</ span > </ span >
359+ < span id ="cb6 -8 "> < a href ="#cb6 -8 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="kw "> -</ span > < span class ="at "> linux-system-roles.metrics</ span > </ span > </ code > </ pre > </ div >
341360< p > Centralized metric recording setup for several remote hosts and
342361scalable metric recording, analysis and visualization setup for the
343362local host, providing a REST API server with an OpenMetrics endpoint,
344363graphs and scalable querying.</ p >
345- < div class ="sourceCode " id ="cb5 "> < pre
346- class ="sourceCode yaml "> < code class ="sourceCode yaml "> < span id ="cb5 -1 "> < a href ="#cb5 -1 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="pp "> ---</ span > </ span >
347- < span id ="cb5 -2 "> < a href ="#cb5 -2 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="kw "> -</ span > < span class ="at "> </ span > < span class ="fu "> name</ span > < span class ="kw "> :</ span > < span class ="at "> Manage centralized metrics gathering</ span > </ span >
348- < span id ="cb5 -3 "> < a href ="#cb5 -3 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> hosts</ span > < span class ="kw "> :</ span > < span class ="at "> monitors</ span > </ span >
349- < span id ="cb5 -4 "> < a href ="#cb5 -4 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> vars</ span > < span class ="kw "> :</ span > </ span >
350- < span id ="cb5 -5 "> < a href ="#cb5 -5 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> metrics_monitored_hosts</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="kw "> [</ span > < span class ="at "> app.example.com</ span > < span class ="kw "> ,</ span > < span class ="at "> db.example.com</ span > < span class ="kw "> ,</ span > < span class ="at "> nas.example.com</ span > < span class ="kw "> ]</ span > </ span >
351- < span id ="cb5 -6 "> < a href ="#cb5 -6 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> metrics_graph_service</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="ch "> true</ span > </ span >
352- < span id ="cb5 -7 "> < a href ="#cb5 -7 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> metrics_query_service</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="ch "> true</ span > </ span >
353- < span id ="cb5 -8 "> < a href ="#cb5 -8 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> roles</ span > < span class ="kw "> :</ span > </ span >
354- < span id ="cb5 -9 "> < a href ="#cb5 -9 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="kw "> -</ span > < span class ="at "> linux-system-roles.metrics</ span > </ span > </ code > </ pre > </ div >
364+ < div class ="sourceCode " id ="cb7 "> < pre
365+ class ="sourceCode yaml "> < code class ="sourceCode yaml "> < span id ="cb7 -1 "> < a href ="#cb7 -1 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="pp "> ---</ span > </ span >
366+ < span id ="cb7 -2 "> < a href ="#cb7 -2 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="kw "> -</ span > < span class ="at "> </ span > < span class ="fu "> name</ span > < span class ="kw "> :</ span > < span class ="at "> Manage centralized metrics gathering</ span > </ span >
367+ < span id ="cb7 -3 "> < a href ="#cb7 -3 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> hosts</ span > < span class ="kw "> :</ span > < span class ="at "> monitors</ span > </ span >
368+ < span id ="cb7 -4 "> < a href ="#cb7 -4 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> vars</ span > < span class ="kw "> :</ span > </ span >
369+ < span id ="cb7 -5 "> < a href ="#cb7 -5 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> metrics_monitored_hosts</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="kw "> [</ span > < span class ="at "> app.example.com</ span > < span class ="kw "> ,</ span > < span class ="at "> db.example.com</ span > < span class ="kw "> ,</ span > < span class ="at "> nas.example.com</ span > < span class ="kw "> ]</ span > </ span >
370+ < span id ="cb7 -6 "> < a href ="#cb7 -6 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> metrics_graph_service</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="ch "> true</ span > </ span >
371+ < span id ="cb7 -7 "> < a href ="#cb7 -7 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> metrics_query_service</ span > < span class ="kw "> :</ span > < span class ="at "> </ span > < span class ="ch "> true</ span > </ span >
372+ < span id ="cb7 -8 "> < a href ="#cb7 -8 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="fu "> roles</ span > < span class ="kw "> :</ span > </ span >
373+ < span id ="cb7 -9 "> < a href ="#cb7 -9 " aria-hidden ="true " tabindex ="-1 "> </ a > < span class ="at "> </ span > < span class ="kw "> -</ span > < span class ="at "> linux-system-roles.metrics</ span > </ span > </ code > </ pre > </ div >
355374< h1 id ="rpm-ostree "> rpm-ostree</ h1 >
356375< p > See README-ostree.md</ p >
357376< h1 id ="license "> License</ h1 >
0 commit comments