You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@karaf.apache.org by jb...@apache.org on 2019/03/22 08:21:27 UTC
svn commit: r1856031 [2/9] - in
/karaf/site/production/manual/decanter/latest-2: ./ dev-guide/ html/
html/dev-guide/ html/images/ html/style/ html/user-guide/ user-guide/
Added: karaf/site/production/manual/decanter/latest-2/html/appenders.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/decanter/latest-2/html/appenders.html?rev=1856031&view=auto
==============================================================================
--- karaf/site/production/manual/decanter/latest-2/html/appenders.html (added)
+++ karaf/site/production/manual/decanter/latest-2/html/appenders.html Fri Mar 22 08:21:26 2019
@@ -0,0 +1,4556 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.6.1">
+<title>Appenders</title>
+<style>
+/*
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+ */
+@import "https://fonts.googleapis.com/css?family=Open+Sans:400,700%7cDroid+Serif:400,700";
+
+article,
+aside,
+details,
+figcaption,
+figure,
+footer,
+header,
+hgroup,
+main,
+nav,
+section,
+summary {
+ display: block
+}
+
+audio,
+canvas,
+video {
+ display: inline-block
+}
+
+audio:not([controls]) {
+ display: none;
+ height: 0
+}
+
+script {
+ display: none !important
+}
+
+html {
+ font-family: "Droid Serif";
+ -ms-text-size-adjust: 100%;
+ -webkit-text-size-adjust: 100%;
+}
+
+a {
+ background: transparent
+}
+
+a:focus {
+ outline: thin dotted
+}
+
+a:active,
+a:hover {
+ outline: 0
+}
+
+h1 {
+ font-size: 2em;
+ margin: .67em 0
+}
+
+abbr[title] {
+ border-bottom: 1px dotted
+}
+
+b,
+strong {
+ font-weight: bold
+}
+
+dfn {
+ font-style: italic
+}
+
+hr {
+ -moz-box-sizing: content-box;
+ box-sizing: content-box;
+ height: 0
+}
+
+mark {
+ background: #ff0;
+ color: #000
+}
+
+code,
+kbd,
+pre,
+samp {
+ font-family: monospace;
+ font-size: 1em
+}
+
+pre {
+ white-space: pre-wrap
+}
+
+q {
+ quotes: "\201C" "\201D" "\2018" "\2019"
+}
+
+small {
+ font-size: 80%
+}
+
+sub,
+sup {
+ font-size: 75%;
+ line-height: 0;
+ position: relative;
+ vertical-align: baseline
+}
+
+sup {
+ top: -.5em
+}
+
+sub {
+ bottom: -.25em
+}
+
+img {
+ border: 0
+}
+
+svg:not(:root) {
+ overflow: hidden
+}
+
+figure {
+ margin: 0
+}
+
+fieldset {
+ border: 1px solid silver;
+ margin: 0 2px;
+ padding: .35em .625em .75em
+}
+
+legend {
+ border: 0;
+ padding: 0
+}
+
+button,
+input,
+select,
+textarea {
+ font-family: inherit;
+ font-size: 100%;
+ margin: 0
+}
+
+button,
+input {
+ line-height: normal
+}
+
+button,
+select {
+ text-transform: none
+}
+
+button,
+html input[type="button"],
+input[type="reset"],
+input[type="submit"] {
+ -webkit-appearance: button;
+ cursor: pointer
+}
+
+button[disabled],
+html input[disabled] {
+ cursor: default
+}
+
+input[type="checkbox"],
+input[type="radio"] {
+ box-sizing: border-box;
+ padding: 0
+}
+
+button::-moz-focus-inner,
+input::-moz-focus-inner {
+ border: 0;
+ padding: 0
+}
+
+textarea {
+ overflow: auto;
+ vertical-align: top
+}
+
+table {
+ border-collapse: collapse;
+ border-spacing: 0
+}
+
+*,
+*::before,
+*::after {
+ -moz-box-sizing: border-box;
+ -webkit-box-sizing: border-box;
+ box-sizing: border-box
+}
+
+html,
+body {
+ /*font-size: 100%*/
+}
+
+body {
+ background: #fff;
+ color: #333;
+ padding: 0;
+ margin: 0;
+ font-family: "Droid Serif", "DejaVu Serif", serif;
+ font-size: 14px;
+ font-style: normal;
+ line-height: 1.42857143;
+ position: relative;
+ cursor: auto;
+ tab-size: 4;
+ -moz-osx-font-smoothing: grayscale;
+ -webkit-font-smoothing: antialiased
+}
+
+a:hover {
+ cursor: pointer
+}
+
+img,
+object,
+embed {
+ max-width: 100%;
+ height: auto
+}
+
+object,
+embed {
+ height: 100%
+}
+
+img {
+ -ms-interpolation-mode: bicubic
+}
+
+.left {
+ float: left !important
+}
+
+.right {
+ float: right !important
+}
+
+.text-left {
+ text-align: left !important
+}
+
+.text-right {
+ text-align: right !important
+}
+
+.text-center {
+ text-align: center !important
+}
+
+.text-justify {
+ text-align: justify !important
+}
+
+.hide {
+ display: none
+}
+
+img,
+object,
+svg {
+ display: inline-block;
+ vertical-align: middle
+}
+
+textarea {
+ height: auto;
+ min-height: 50px
+}
+
+select {
+ width: 100%
+}
+
+.center {
+ margin-left: auto;
+ margin-right: auto
+}
+
+.stretch {
+ width: 100%
+}
+
+.subheader,
+.admonitionblock td.content>.title,
+.audioblock>.title,
+.exampleblock>.title,
+.imageblock>.title,
+.listingblock>.title,
+.literalblock>.title,
+.stemblock>.title,
+.openblock>.title,
+.paragraph>.title,
+.quoteblock>.title,
+table.tableblock>.title,
+.verseblock>.title,
+.videoblock>.title,
+.dlist>.title,
+.olist>.title,
+.ulist>.title,
+.qlist>.title,
+.hdlist>.title {
+ line-height: 1.45;
+ color: #585ac2;
+ font-weight: 400;
+ margin-top: 0;
+ margin-bottom: .25em
+}
+
+div,
+dl,
+dt,
+dd,
+ul,
+ol,
+li,
+h1,
+h2,
+h3,
+#toctitle,
+.sidebarblock>.content>.title,
+h4,
+h5,
+h6,
+pre,
+form,
+p,
+blockquote,
+th,
+td {
+ margin: 0;
+ padding: 0;
+ direction: ltr
+}
+
+a {
+ color: #585ac2;
+ text-decoration: underline;
+ line-height: inherit
+}
+
+a:hover,
+a:focus {
+ color: #373997;
+}
+
+a img {
+ border: none
+}
+
+p {
+ font-family: inherit;
+ font-weight: 400;
+ font-size: 1em;
+ line-height: 1.6;
+ margin-bottom: 1.25em;
+ text-rendering: optimizeLegibility
+}
+
+p aside {
+ font-size: .875em;
+ line-height: 1.35;
+ font-style: italic
+}
+
+h1,
+h2,
+h3,
+#toctitle,
+.sidebarblock>.content>.title,
+h4,
+h5,
+h6 {
+ font-family: "Source Sans Pro", "DejaVu Sans", sans-serif;
+ font-weight: bold;
+ /*font-style: bold;*/
+ color: #303284;
+ text-rendering: optimizeLegibility;
+ margin-top: 1em;
+ margin-bottom: .5em;
+ line-height: 1.0125em;
+ text-transform: uppercase;
+}
+
+h1 small,
+h2 small,
+h3 small,
+#toctitle small,
+.sidebarblock>.content>.title small,
+h4 small,
+h5 small,
+h6 small {
+ font-size: 60%;
+ color: #303284;
+ line-height: 0
+}
+
+h1 {
+ font-size: 2.125em
+}
+
+h2 {
+ font-size: 1.6875em
+}
+
+h3,
+#toctitle,
+.sidebarblock>.content>.title {
+ font-size: 1.375em
+}
+
+h4,
+h5 {
+ font-size: 1.125em
+}
+
+h6 {
+ font-size: 1em
+}
+
+hr {
+ border: solid #dddddd;
+ border-width: 1px 0 0;
+ clear: both;
+ margin: 1.25em 0 1.1875em;
+ height: 0
+}
+
+em,
+i {
+ font-style: italic;
+ line-height: inherit
+}
+
+strong,
+b {
+ font-weight: bold;
+ line-height: inherit
+}
+
+small {
+ font-size: 60%;
+ line-height: inherit
+}
+
+code {
+ font-family: "Droid Sans Mono", "DejaVu Sans Mono", monospace;
+ font-weight: 400;
+ color: #585ac2;
+}
+
+ul,
+ol,
+dl {
+ font-size: 1em;
+ line-height: 1.6;
+ margin-bottom: 1.25em;
+ list-style-position: outside;
+ font-family: inherit
+}
+
+ul,
+ol {
+ margin-left: 1.5em
+}
+
+ul li ul,
+ul li ol {
+ margin-left: 1.25em;
+ margin-bottom: 0;
+ font-size: 1em
+}
+
+ul.square li ul,
+ul.circle li ul,
+ul.disc li ul {
+ list-style: inherit
+}
+
+ul.square {
+ list-style-type: square
+}
+
+ul.circle {
+ list-style-type: circle
+}
+
+ul.disc {
+ list-style-type: disc
+}
+
+ol li ul,
+ol li ol {
+ margin-left: 1.25em;
+ margin-bottom: 0
+}
+
+dl dt {
+ margin-bottom: .3125em;
+ font-weight: bold
+}
+
+dl dd {
+ margin-bottom: 1.25em
+}
+
+abbr,
+acronym {
+ text-transform: uppercase;
+ font-size: 90%;
+ color: rgba(0, 0, 0, .8);
+ border-bottom: 1px dotted #ddd;
+ cursor: help
+}
+
+abbr {
+ text-transform: none
+}
+
+blockquote {
+ margin: 0 0 1.25em;
+ padding: .5625em 1.25em 0 1.1875em;
+ border-left: 1px solid #ddd
+}
+
+blockquote cite {
+ display: block;
+ font-size: .9375em;
+ color: rgba(0, 0, 0, .6)
+}
+
+blockquote cite::before {
+ content: "\2014 \0020"
+}
+
+blockquote cite a,
+blockquote cite a:visited {
+ color: rgba(0, 0, 0, .6)
+}
+
+blockquote,
+blockquote p {
+ line-height: 1.6;
+ color: rgba(0, 0, 0, .85)
+}
+
+@media screen and (min-width:768px) {
+ h1,
+ h2,
+ h3,
+ #toctitle,
+ .sidebarblock>.content>.title,
+ h4,
+ h5,
+ h6 {
+ line-height: 1.2
+ }
+
+ h1 {
+ font-size: 2.75em
+ }
+
+ h2 {
+ font-size: 2.3125em
+ }
+
+ h3,
+ #toctitle,
+ .sidebarblock>.content>.title {
+ font-size: 1.6875em
+ }
+
+ h4 {
+ font-size: 1.4375em
+ }
+
+}
+
+table {
+ background: #fff;
+ margin-bottom: 1.25em;
+ border: solid 1px #dddddd;
+}
+
+table thead,
+table tfoot {
+ background: #f7f8f7
+}
+
+table thead tr th,
+table thead tr td,
+table tfoot tr th,
+table tfoot tr td {
+ padding: .5em .625em .625em;
+ font-size: inherit;
+ color: rgba(0, 0, 0, .8);
+ text-align: left
+}
+
+table tr th,
+table tr td {
+ padding: .5625em .625em;
+ font-size: inherit;
+ color: rgba(0, 0, 0, .8)
+}
+
+table tr.even,
+table tr.alt,
+table tr:nth-of-type(even) {
+ background: #f8f8f7
+}
+
+table thead tr th,
+table tfoot tr th,
+table tbody tr td,
+table tr td,
+table tfoot tr td {
+ display: table-cell;
+ line-height: 1.6
+}
+
+h1,
+h2,
+h3,
+#toctitle,
+.sidebarblock>.content>.title,
+h4,
+h5,
+h6 {
+ line-height: 1.2;
+ word-spacing: -.05em
+}
+
+h1 strong,
+h2 strong,
+h3 strong,
+#toctitle strong,
+.sidebarblock>.content>.title strong,
+h4 strong,
+h5 strong,
+h6 strong {
+ font-weight: 400
+}
+
+.clearfix::before,
+.clearfix::after,
+.float-group::before,
+.float-group::after {
+ content: " ";
+ display: table
+}
+
+.clearfix::after,
+.float-group::after {
+ clear: both
+}
+
+*:not(pre)>code {
+ font-size: .9375em;
+ font-style: normal !important;
+ letter-spacing: 0;
+ padding: .1em .5ex;
+ word-spacing: -.15em;
+ background-color: #f7f7f8;
+ -webkit-border-radius: 4px;
+ border-radius: 4px;
+ line-height: 1.45;
+ text-rendering: optimizeSpeed;
+ word-wrap: break-word
+}
+
+*:not(pre)>code.nobreak {
+ word-wrap: normal
+}
+
+*:not(pre)>code.nowrap {
+ white-space: nowrap
+}
+
+pre,
+pre>code {
+ line-height: 1.45;
+ color: #585ac2;
+ font-family: "Droid Sans Mono", "DejaVu Sans Mono", monospace;
+ font-weight: 400;
+ text-rendering: optimizeSpeed
+}
+
+em em {
+ font-style: normal
+}
+
+strong strong {
+ font-weight: 400
+}
+
+.keyseq {
+ color: rgba(51, 51, 51, .8)
+}
+
+kbd {
+ font-family: "Droid Sans Mono", "DejaVu Sans Mono", monospace;
+ display: inline-block;
+ color: rgba(0, 0, 0, .8);
+ font-size: .65em;
+ line-height: 1.45;
+ background-color: #f7f7f7;
+ border: 1px solid #dddddd;
+ -webkit-border-radius: 3px;
+ border-radius: 3px;
+ -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em white inset;
+ box-shadow: 0 1px 0 rgba(0, 0, 0, .2), 0 0 0 .1em #fff inset;
+ margin: 0 .15em;
+ padding: .2em .5em;
+ vertical-align: middle;
+ position: relative;
+ top: -.1em;
+ white-space: nowrap
+}
+
+.keyseq kbd:first-child {
+ margin-left: 0
+}
+
+.keyseq kbd:last-child {
+ margin-right: 0
+}
+
+.menuseq,
+.menuref {
+ color: #000
+}
+
+.menuseq b:not(.caret),.menuref {
+ font-weight: inherit
+}
+
+.menuseq {
+ word-spacing: -.02em
+}
+
+.menuseq b.caret {
+ font-size: 1.25em;
+ line-height: .8
+}
+
+.menuseq i.caret {
+ font-weight: bold;
+ text-align: center;
+ width: .45em
+}
+
+b.button::before,
+b.button::after {
+ position: relative;
+ top: -1px;
+ font-weight: 400
+}
+
+b.button::before {
+ content: "[";
+ padding: 0 3px 0 2px
+}
+
+b.button::after {
+ content: "]";
+ padding: 0 2px 0 3px
+}
+
+p a>code:hover {
+ color: #585ac2;
+}
+
+#header,
+#content,
+#footnotes,
+#footer {
+ width: 100%;
+ margin-left: auto;
+ margin-right: auto;
+ margin-top: 0;
+ margin-bottom: 0;
+ max-width: 62.5em;
+ *zoom: 1;
+ position: relative;
+ padding-left: .9375em;
+ padding-right: .9375em
+}
+
+#header::before,
+#header::after,
+#content::before,
+#content::after,
+#footnotes::before,
+#footnotes::after,
+#footer::before,
+#footer::after {
+ content: " ";
+ display: table
+}
+
+#header::after,
+#content::after,
+#footnotes::after,
+#footer::after {
+ clear: both
+}
+
+#content {
+ margin-top: 1.25em
+}
+
+#content::before {
+ content: none
+}
+
+#header>h1:first-child {
+ color: #303284;
+ margin-top: 2.25rem;
+ margin-bottom: 0
+}
+
+#header>h1:first-child+#toc {
+ margin-top: 8px;
+ border-top: 1px solid #dddddd
+}
+
+#header>h1:only-child,
+body.toc2 #header>h1:nth-last-child(2) {
+ border-bottom: 1px solid #dddddd;
+ padding-bottom: 8px
+}
+
+#header .details {
+ border-bottom: 1px solid #dddddd;
+ line-height: 1.45;
+ padding-top: .25em;
+ padding-bottom: .25em;
+ padding-left: .25em;
+ color: rgba(0, 0, 0, .6);
+ display: -ms-flexbox;
+ display: -webkit-flex;
+ display: flex;
+ -ms-flex-flow: row wrap;
+ -webkit-flex-flow: row wrap;
+ flex-flow: row wrap
+}
+
+#header .details span:first-child {
+ margin-left: -.125em
+}
+
+#header .details span.email a {
+ color: rgba(0, 0, 0, .85)
+}
+
+#header .details br {
+ display: none
+}
+
+#header .details br+span::before {
+ content: "\00a0\2013\00a0"
+}
+
+#header .details br+span.author::before {
+ content: "\00a0\22c5\00a0";
+ color: rgba(0, 0, 0, .85)
+}
+
+#header .details br+span#revremark::before {
+ content: "\00a0|\00a0"
+}
+
+#header #revnumber {
+ text-transform: capitalize
+}
+
+#header #revnumber::after {
+ content: "\00a0"
+}
+
+#content>h1:first-child:not([class]) {
+ color: rgba(0, 0, 0, .85);
+ border-bottom: 1px solid #dddddd
+;
+ padding-bottom: 8px;
+ margin-top: 0;
+ padding-top: 1rem;
+ margin-bottom: 1.25rem
+}
+
+#toc {
+ border-bottom: 1px solid #dddddd;
+ padding-bottom: .5em
+}
+
+#toc>ul {
+ margin-left: .125em
+}
+
+#toc ul.sectlevel0>li>a {
+ font-style: italic
+}
+
+#toc ul.sectlevel0 ul.sectlevel1 {
+ margin: .5em 0
+}
+
+#toc ul {
+ font-family: "Droid Serif", "DejaVu Sans", sans-serif;
+ list-style-type: none
+}
+
+#toc li {
+ line-height: 1.3334;
+ margin-top: .3334em
+}
+
+#toc a {
+ text-decoration: none
+}
+
+#toc a:active {
+ text-decoration: underline
+}
+
+#toctitle {
+ color: #303284;
+ font-size: 1.2em
+}
+
+@media screen and (min-width:768px) {
+ #toctitle {
+ font-size: 1.375em
+ }
+
+ body.toc2 {
+ padding-left: 15em;
+ padding-right: 0
+ }
+
+ #toc.toc2 {
+ margin-top: 0 !important;
+ background-color: #eee;
+ position: fixed;
+ width: 15em;
+ left: 0;
+ top: 0;
+ border-right: 1px solid #dddddd;
+ border-top-width: 0 !important;
+ border-bottom-width: 0 !important;
+ z-index: 1000;
+ padding: 1.25em 1em;
+ height: 100%;
+ overflow: auto
+ }
+
+ #toc.toc2 #toctitle {
+ margin-top: 0;
+ margin-bottom: .8rem;
+ font-size: 1.2em
+ }
+
+ #toc.toc2>ul {
+ font-size: .9em;
+ margin-bottom: 0
+ }
+
+ #toc.toc2 ul ul {
+ margin-left: 0;
+ padding-left: 1em
+ }
+
+ #toc.toc2 ul.sectlevel0 ul.sectlevel1 {
+ padding-left: 0;
+ margin-top: .5em;
+ margin-bottom: .5em
+ }
+
+ body.toc2.toc-right {
+ padding-left: 0;
+ padding-right: 15em
+ }
+
+ body.toc2.toc-right #toc.toc2 {
+ border-right-width: 0;
+ border-left: 1px solid #dddddd;
+ left: auto;
+ right: 0
+ }
+
+}
+
+@media screen and (min-width:1280px) {
+ body.toc2 {
+ padding-left: 20em;
+ padding-right: 0
+ }
+
+ #toc.toc2 {
+ width: 20em
+ }
+
+ #toc.toc2 #toctitle {
+ font-size: 1.375em
+ }
+
+ #toc.toc2>ul {
+ font-size: .95em
+ }
+
+ #toc.toc2 ul ul {
+ padding-left: 1.25em
+ }
+
+ body.toc2.toc-right {
+ padding-left: 0;
+ padding-right: 20em
+ }
+
+}
+
+#content #toc {
+ border-style: solid;
+ border-width: 1px;
+ border-color: #dddddd;
+ margin-bottom: 1.25em;
+ padding: 1.25em;
+ background: #f8f8f7;
+ -webkit-border-radius: 4px;
+ border-radius: 4px
+}
+
+#content #toc>:first-child {
+ margin-top: 0
+}
+
+#content #toc>:last-child {
+ margin-bottom: 0
+}
+
+#footer {
+ max-width: 100%;
+ background-color: #303284;
+ padding: 1.25em
+}
+
+#footer-text {
+ color: #fff;
+ line-height: 1.44
+}
+
+#content {
+ margin-bottom: .625em
+}
+
+.sect1 {
+ padding-bottom: .625em
+}
+
+@media screen and (min-width:768px) {
+ #content {
+ margin-bottom: 1.25em
+ }
+
+ .sect1 {
+ padding-bottom: 1.25em
+ }
+
+}
+
+.sect1:last-child {
+ padding-bottom: 0
+}
+
+.sect1+.sect1 {
+ border-top: 1px solid #dddddd;
+}
+
+#content h1>a.anchor,
+h2>a.anchor,
+h3>a.anchor,
+#toctitle>a.anchor,
+.sidebarblock>.content>.title>a.anchor,
+h4>a.anchor,
+h5>a.anchor,
+h6>a.anchor {
+ position: absolute;
+ z-index: 1001;
+ width: 1.5ex;
+ margin-left: -1.5ex;
+ display: block;
+ text-decoration: none !important;
+ visibility: hidden;
+ text-align: center;
+ font-weight: 400
+}
+
+#content h1>a.anchor::before,
+h2>a.anchor::before,
+h3>a.anchor::before,
+#toctitle>a.anchor::before,
+.sidebarblock>.content>.title>a.anchor::before,
+h4>a.anchor::before,
+h5>a.anchor::before,
+h6>a.anchor::before {
+ content: "\00A7";
+ font-size: .85em;
+ display: block;
+ padding-top: .1em
+}
+
+#content h1:hover>a.anchor,
+#content h1>a.anchor:hover,
+h2:hover>a.anchor,
+h2>a.anchor:hover,
+h3:hover>a.anchor,
+#toctitle:hover>a.anchor,
+.sidebarblock>.content>.title:hover>a.anchor,
+h3>a.anchor:hover,
+#toctitle>a.anchor:hover,
+.sidebarblock>.content>.title>a.anchor:hover,
+h4:hover>a.anchor,
+h4>a.anchor:hover,
+h5:hover>a.anchor,
+h5>a.anchor:hover,
+h6:hover>a.anchor,
+h6>a.anchor:hover {
+ visibility: visible
+}
+
+#content h1>a.link,
+h2>a.link,
+h3>a.link,
+#toctitle>a.link,
+.sidebarblock>.content>.title>a.link,
+h4>a.link,
+h5>a.link,
+h6>a.link {
+ color: #ba3925;
+ text-decoration: none
+}
+
+#content h1>a.link:hover,
+h2>a.link:hover,
+h3>a.link:hover,
+#toctitle>a.link:hover,
+.sidebarblock>.content>.title>a.link:hover,
+h4>a.link:hover,
+h5>a.link:hover,
+h6>a.link:hover {
+ color: #a53221
+}
+
+.audioblock,
+.imageblock,
+.literalblock,
+.listingblock,
+.stemblock,
+.videoblock {
+ margin-bottom: 1.25em
+}
+
+.admonitionblock td.content>.title,
+.audioblock>.title,
+.exampleblock>.title,
+.imageblock>.title,
+.listingblock>.title,
+.literalblock>.title,
+.stemblock>.title,
+.openblock>.title,
+.paragraph>.title,
+.quoteblock>.title,
+table.tableblock>.title,
+.verseblock>.title,
+.videoblock>.title,
+.dlist>.title,
+.olist>.title,
+.ulist>.title,
+.qlist>.title,
+.hdlist>.title {
+ text-rendering: optimizeLegibility;
+ text-align: left;
+ font-family: "Droid Serif", "DejaVu Serif", serif;
+ font-size: 1rem;
+ font-style: italic
+}
+
+table.tableblock.fit-content>caption.title {
+ white-space: nowrap;
+ width: 0
+}
+
+.paragraph.lead>p,
+#preamble>.sectionbody>[class="paragraph"]:first-of-type p {
+ font-size: 1.21875em;
+ line-height: 1.6;
+ color: rgba(0, 0, 0, .85)
+}
+
+table.tableblock #preamble>.sectionbody>[class="paragraph"]:first-of-type p {
+ font-size: inherit
+}
+
+.admonitionblock>table {
+ border-collapse: separate;
+ border: 0;
+ background: none;
+ width: 100%
+}
+
+.admonitionblock>table td.icon {
+ text-align: center;
+ width: 80px
+}
+
+.admonitionblock>table td.icon img {
+ max-width: none
+}
+
+.admonitionblock>table td.icon .title {
+ font-weight: bold;
+ font-family: "Source Sans Pro", "DejaVu Sans", sans-serif;
+ text-transform: uppercase
+}
+
+.admonitionblock>table td.content {
+ padding-left: 1.125em;
+ padding-right: 1.25em;
+ border-left: 1px solid #dddddd;
+ color: rgba(0, 0, 0, .6)
+}
+
+.admonitionblock>table td.content>:last-child>:last-child {
+ margin-bottom: 0
+}
+
+.exampleblock>.content {
+ border-style: solid;
+ border-width: 1px;
+ border-color: #dddddd;
+ margin-bottom: 1.25em;
+ padding: 1.25em;
+ background: #fff;
+ -webkit-border-radius: 4px;
+ border-radius: 4px
+}
+
+.exampleblock>.content>:first-child {
+ margin-top: 0
+}
+
+.exampleblock>.content>:last-child {
+ margin-bottom: 0
+}
+
+.sidebarblock {
+ border-style: solid;
+ border-width: 1px;
+ border-color: #dddddd;
+ margin-bottom: 1.25em;
+ padding: 1.25em;
+ background: #f8f8f7;
+ -webkit-border-radius: 4px;
+ border-radius: 4px
+}
+
+.sidebarblock>:first-child {
+ margin-top: 0
+}
+
+.sidebarblock>:last-child {
+ margin-bottom: 0
+}
+
+.sidebarblock>.content>.title {
+ color: #303284;
+ margin-top: 0;
+ text-align: center
+}
+
+.exampleblock>.content>:last-child>:last-child,
+.exampleblock>.content .olist>ol>li:last-child>:last-child,
+.exampleblock>.content .ulist>ul>li:last-child>:last-child,
+.exampleblock>.content .qlist>ol>li:last-child>:last-child,
+.sidebarblock>.content>:last-child>:last-child,
+.sidebarblock>.content .olist>ol>li:last-child>:last-child,
+.sidebarblock>.content .ulist>ul>li:last-child>:last-child,
+.sidebarblock>.content .qlist>ol>li:last-child>:last-child {
+ margin-bottom: 0
+}
+
+.literalblock pre,
+.listingblock pre:not(.highlight),.listingblock pre[class="highlight"],.listingblock pre[class^="highlight "],.listingblock pre.CodeRay,.listingblock pre.prettyprint {
+ background: #f7f7f8
+}
+
+.sidebarblock .literalblock pre,
+.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class="highlight"],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint {
+ background: #f2f1f1
+}
+
+.literalblock pre,
+.literalblock pre[class],
+.listingblock pre,
+.listingblock pre[class] {
+ -webkit-border-radius: 4px;
+ border-radius: 4px;
+ word-wrap: break-word;
+ padding: 1em;
+ font-size: .8125em
+}
+
+.literalblock pre.nowrap,
+.literalblock pre[class].nowrap,
+.listingblock pre.nowrap,
+.listingblock pre[class].nowrap {
+ overflow-x: auto;
+ white-space: pre;
+ word-wrap: normal
+}
+
+@media screen and (min-width:768px) {
+ .literalblock pre,
+ .literalblock pre[class],
+ .listingblock pre,
+ .listingblock pre[class] {
+ font-size: .90625em
+ }
+
+}
+
+@media screen and (min-width:1280px) {
+ .literalblock pre,
+ .literalblock pre[class],
+ .listingblock pre,
+ .listingblock pre[class] {
+ font-size: 1em
+ }
+
+}
+
+.literalblock.output pre {
+ color: #f7f7f8;
+ background-color: rgba(0, 0, 0, .9)
+}
+
+.listingblock pre.highlightjs {
+ padding: 0
+}
+
+.listingblock pre.highlightjs>code {
+ padding: 1em;
+ -webkit-border-radius: 4px;
+ border-radius: 4px
+}
+
+.listingblock pre.prettyprint {
+ border-width: 0
+}
+
+.listingblock>.content {
+ position: relative
+}
+
+.listingblock code[data-lang]::before {
+ display: none;
+ content: attr(data-lang);
+ position: absolute;
+ font-size: .75em;
+ top: .425rem;
+ right: .5rem;
+ line-height: 1;
+ text-transform: uppercase;
+ color: #999
+}
+
+.listingblock:hover code[data-lang]::before {
+ display: block
+}
+
+.listingblock.terminal pre .command::before {
+ content: attr(data-prompt);
+ padding-right: .5em;
+ color: #999
+}
+
+.listingblock.terminal pre .command:not([data-prompt])::before {
+ content: "$"
+}
+
+table.pyhltable {
+ border-collapse: separate;
+ border: 0;
+ margin-bottom: 0;
+ background: none
+}
+
+table.pyhltable td {
+ vertical-align: top;
+ padding-top: 0;
+ padding-bottom: 0;
+ line-height: 1.45
+}
+
+table.pyhltable td.code {
+ padding-left: .75em;
+ padding-right: 0
+}
+
+pre.pygments .lineno,
+table.pyhltable td:not(.code) {
+ color: #999;
+ padding-left: 0;
+ padding-right: .5em;
+ border-right: 1px solid #dddddd;
+}
+
+pre.pygments .lineno {
+ display: inline-block;
+ margin-right: .25em
+}
+
+table.pyhltable .linenodiv {
+ background: none !important;
+ padding-right: 0 !important
+}
+
+.quoteblock {
+ margin: 0 1em 1.25em 1.5em;
+ display: table
+}
+
+.quoteblock>.title {
+ margin-left: -1.5em;
+ margin-bottom: .75em
+}
+
+.quoteblock blockquote,
+.quoteblock blockquote p {
+ color: rgba(0, 0, 0, .85);
+ font-size: 1.05rem;
+ line-height: 1.75;
+ word-spacing: .1em;
+ letter-spacing: 0;
+ font-style: italic;
+ text-align: justify
+}
+
+.quoteblock blockquote {
+ margin: 0;
+ padding: 0;
+ border: 0
+}
+
+.quoteblock blockquote::before {
+ content: "\201c";
+ float: left;
+ font-size: 2.75em;
+ font-weight: bold;
+ line-height: .6em;
+ margin-left: -.6em;
+ color: #303284;
+ text-shadow: 0 1px 2px rgba(0, 0, 0, .1)
+}
+
+.quoteblock blockquote>.paragraph:last-child p {
+ margin-bottom: 0
+}
+
+.quoteblock .attribution {
+ margin-top: .5em;
+ margin-right: .5ex;
+ text-align: right
+}
+
+.quoteblock .quoteblock {
+ margin-left: 0;
+ margin-right: 0;
+ padding: .5em 0;
+ border-left: 3px solid rgba(0, 0, 0, .6)
+}
+
+.quoteblock .quoteblock blockquote {
+ padding: 0 0 0 .75em
+}
+
+.quoteblock .quoteblock blockquote::before {
+ display: none
+}
+
+.verseblock {
+ margin: 0 1em 1.25em
+}
+
+.verseblock pre {
+ font-family: "Source Sans Pro", "DejaVu Sans", sans;
+ font-size: 1.15rem;
+ color: rgba(0, 0, 0, .85);
+ font-weight: 300;
+ text-rendering: optimizeLegibility
+}
+
+.verseblock pre strong {
+ font-weight: 400
+}
+
+.verseblock .attribution {
+ margin-top: 1.25rem;
+ margin-left: .5ex
+}
+
+.quoteblock .attribution,
+.verseblock .attribution {
+ font-size: .9375em;
+ line-height: 1.45;
+ font-style: italic
+}
+
+.quoteblock .attribution br,
+.verseblock .attribution br {
+ display: none
+}
+
+.quoteblock .attribution cite,
+.verseblock .attribution cite {
+ display: block;
+ letter-spacing: -.025em;
+ color: rgba(0, 0, 0, .6)
+}
+
+.quoteblock.abstract {
+ margin: 0 1em 1.25em;
+ display: block
+}
+
+.quoteblock.abstract>.title {
+ margin: 0 0 .375em;
+ font-size: 1.15em;
+ text-align: center
+}
+
+.quoteblock.abstract blockquote,
+.quoteblock.abstract blockquote p {
+ word-spacing: 0;
+ line-height: 1.6
+}
+
+.quoteblock.abstract blockquote::before,
+.quoteblock.abstract p::before {
+ display: none
+}
+
+table.tableblock {
+ max-width: 100%;
+ border-collapse: separate
+}
+
+p.tableblock:last-child {
+ margin-bottom: 0
+}
+
+td.tableblock>.content {
+ margin-bottom: -1.25em
+}
+
+table.tableblock,
+th.tableblock,
+td.tableblock {
+ border: 0 solid #dddddd;
+}
+
+table.grid-all>thead>tr>.tableblock,
+table.grid-all>tbody>tr>.tableblock {
+ border-width: 0 1px 1px 0
+}
+
+table.grid-all>tfoot>tr>.tableblock {
+ border-width: 1px 1px 0 0
+}
+
+table.grid-cols>*>tr>.tableblock {
+ border-width: 0 1px 0 0
+}
+
+table.grid-rows>thead>tr>.tableblock,
+table.grid-rows>tbody>tr>.tableblock {
+ border-width: 0 0 1px
+}
+
+table.grid-rows>tfoot>tr>.tableblock {
+ border-width: 1px 0 0
+}
+
+table.grid-all>*>tr>.tableblock:last-child,
+table.grid-cols>*>tr>.tableblock:last-child {
+ border-right-width: 0
+}
+
+table.grid-all>tbody>tr:last-child>.tableblock,
+table.grid-all>thead:last-child>tr>.tableblock,
+table.grid-rows>tbody>tr:last-child>.tableblock,
+table.grid-rows>thead:last-child>tr>.tableblock {
+ border-bottom-width: 0
+}
+
+table.frame-all {
+ border-width: 1px
+}
+
+table.frame-sides {
+ border-width: 0 1px
+}
+
+table.frame-topbot,
+table.frame-ends {
+ border-width: 1px 0
+}
+
+table.stripes-all tr,
+table.stripes-odd tr:nth-of-type(odd) {
+ background: #f8f8f7
+}
+
+table.stripes-none tr,
+table.stripes-odd tr:nth-of-type(even) {
+ background: none
+}
+
+th.halign-left,
+td.halign-left {
+ text-align: left
+}
+
+th.halign-right,
+td.halign-right {
+ text-align: right
+}
+
+th.halign-center,
+td.halign-center {
+ text-align: center
+}
+
+th.valign-top,
+td.valign-top {
+ vertical-align: top
+}
+
+th.valign-bottom,
+td.valign-bottom {
+ vertical-align: bottom
+}
+
+th.valign-middle,
+td.valign-middle {
+ vertical-align: middle
+}
+
+table thead th,
+table tfoot th {
+ font-weight: bold
+}
+
+tbody tr th {
+ display: table-cell;
+ line-height: 1.6;
+ background: #f7f8f7
+}
+
+tbody tr th,
+tbody tr th p,
+tfoot tr th,
+tfoot tr th p {
+ color: rgba(0, 0, 0, .8);
+ font-weight: bold
+}
+
+p.tableblock>code:only-child {
+ background: none;
+ padding: 0
+}
+
+p.tableblock {
+ font-size: 1em
+}
+
+td>div.verse {
+ white-space: pre
+}
+
+ol {
+ margin-left: 1.75em
+}
+
+ul li ol {
+ margin-left: 1.5em
+}
+
+dl dd {
+ margin-left: 1.125em
+}
+
+dl dd:last-child,
+dl dd:last-child>:last-child {
+ margin-bottom: 0
+}
+
+ol>li p,
+ul>li p,
+ul dd,
+ol dd,
+.olist .olist,
+.ulist .ulist,
+.ulist .olist,
+.olist .ulist {
+ margin-bottom: .625em
+}
+
+ul.checklist,
+ul.none,
+ol.none,
+ul.no-bullet,
+ol.no-bullet,
+ol.unnumbered,
+ul.unstyled,
+ol.unstyled {
+ list-style-type: none
+}
+
+ul.no-bullet,
+ol.no-bullet,
+ol.unnumbered {
+ margin-left: .625em
+}
+
+ul.unstyled,
+ol.unstyled {
+ margin-left: 0
+}
+
+ul.checklist {
+ margin-left: .625em
+}
+
+ul.checklist li>p:first-child>.fa-square-o:first-child,
+ul.checklist li>p:first-child>.fa-check-square-o:first-child {
+ width: 1.25em;
+ font-size: .8em;
+ position: relative;
+ bottom: .125em
+}
+
+ul.checklist li>p:first-child>input[type="checkbox"]:first-child {
+ margin-right: .25em
+}
+
+ul.inline {
+ display: -ms-flexbox;
+ display: -webkit-box;
+ display: flex;
+ -ms-flex-flow: row wrap;
+ -webkit-flex-flow: row wrap;
+ flex-flow: row wrap;
+ list-style: none;
+ margin: 0 0 .625em -1.25em
+}
+
+ul.inline>li {
+ margin-left: 1.25em
+}
+
+.unstyled dl dt {
+ font-weight: 400;
+ font-style: normal
+}
+
+ol.arabic {
+ list-style-type: decimal
+}
+
+ol.decimal {
+ list-style-type: decimal-leading-zero
+}
+
+ol.loweralpha {
+ list-style-type: lower-alpha
+}
+
+ol.upperalpha {
+ list-style-type: upper-alpha
+}
+
+ol.lowerroman {
+ list-style-type: lower-roman
+}
+
+ol.upperroman {
+ list-style-type: upper-roman
+}
+
+ol.lowergreek {
+ list-style-type: lower-greek
+}
+
+.hdlist>table,
+.colist>table {
+ border: 0;
+ background: none
+}
+
+.hdlist>table>tbody>tr,
+.colist>table>tbody>tr {
+ background: none
+}
+
+td.hdlist1,
+td.hdlist2 {
+ vertical-align: top;
+ padding: 0 .625em
+}
+
+td.hdlist1 {
+ font-weight: bold;
+ padding-bottom: 1.25em
+}
+
+.literalblock+.colist,
+.listingblock+.colist {
+ margin-top: -.5em
+}
+
+.colist td:not([class]):first-child {
+ padding: .4em .75em 0;
+ line-height: 1;
+ vertical-align: top
+}
+
+.colist td:not([class]):first-child img {
+ max-width: none
+}
+
+.colist td:not([class]):last-child {
+ padding: .25em 0
+}
+
+.thumb,
+.th {
+ line-height: 0;
+ display: inline-block;
+ border: solid 4px #fff;
+ -webkit-box-shadow: 0 0 0 1px #ddd;
+ box-shadow: 0 0 0 1px #ddd
+}
+
+.imageblock.left,
+.imageblock[style*="float:left"] {
+ margin: .25em .625em 1.25em 0
+}
+
+.imageblock.right,
+.imageblock[style*="float:right"] {
+ margin: .25em 0 1.25em .625em
+}
+
+.imageblock>.title {
+ margin-bottom: 0
+}
+
+.imageblock.thumb,
+.imageblock.th {
+ border-width: 6px
+}
+
+.imageblock.thumb>.title,
+.imageblock.th>.title {
+ padding: 0 .125em
+}
+
+.image.left,
+.image.right {
+ margin-top: .25em;
+ margin-bottom: .25em;
+ display: inline-block;
+ line-height: 0
+}
+
+.image.left {
+ margin-right: .625em
+}
+
+.image.right {
+ margin-left: .625em
+}
+
+a.image {
+ text-decoration: none;
+ display: inline-block
+}
+
+a.image object {
+ pointer-events: none
+}
+
+sup.footnote,
+sup.footnoteref {
+ font-size: .875em;
+ position: static;
+ vertical-align: super
+}
+
+sup.footnote a,
+sup.footnoteref a {
+ text-decoration: none
+}
+
+sup.footnote a:active,
+sup.footnoteref a:active {
+ text-decoration: underline
+}
+
+#footnotes {
+ padding-top: .75em;
+ padding-bottom: .75em;
+ margin-bottom: .625em
+}
+
+#footnotes hr {
+ width: 20%;
+ min-width: 6.25em;
+ margin: -.25em 0 .75em;
+ border-width: 1px 0 0
+}
+
+#footnotes .footnote {
+ padding: 0 .375em 0 .225em;
+ line-height: 1.3334;
+ font-size: .875em;
+ margin-left: 1.2em;
+ margin-bottom: .2em
+}
+
+#footnotes .footnote a:first-of-type {
+ font-weight: bold;
+ text-decoration: none;
+ margin-left: -1.05em
+}
+
+#footnotes .footnote:last-of-type {
+ margin-bottom: 0
+}
+
+#content #footnotes {
+ margin-top: -.625em;
+ margin-bottom: 0;
+ padding: .75em 0
+}
+
+.gist .file-data>table {
+ border: 0;
+ background: #fff;
+ width: 100%;
+ margin-bottom: 0
+}
+
+.gist .file-data>table td.line-data {
+ width: 99%
+}
+
+div.unbreakable {
+ page-break-inside: avoid
+}
+
+.big {
+ font-size: larger
+}
+
+.small {
+ font-size: smaller
+}
+
+.underline {
+ text-decoration: underline
+}
+
+.overline {
+ text-decoration: overline
+}
+
+.line-through {
+ text-decoration: line-through
+}
+
+.aqua {
+ color: #00bfbf
+}
+
+.aqua-background {
+ background-color: #00fafa
+}
+
+.black {
+ color: #000
+}
+
+.black-background {
+ background-color: #000
+}
+
+.blue {
+ color: #0000bf
+}
+
+.blue-background {
+ background-color: #0000fa
+}
+
+.fuchsia {
+ color: #bf00bf
+}
+
+.fuchsia-background {
+ background-color: #fa00fa
+}
+
+.gray {
+ color: #606060
+}
+
+.gray-background {
+ background-color: #7d7d7d
+}
+
+.green {
+ color: #006000
+}
+
+.green-background {
+ background-color: #007d00
+}
+
+.lime {
+ color: #00bf00
+}
+
+.lime-background {
+ background-color: #00fa00
+}
+
+.maroon {
+ color: #600000
+}
+
+.maroon-background {
+ background-color: #7d0000
+}
+
+.navy {
+ color: #000060
+}
+
+.navy-background {
+ background-color: #00007d
+}
+
+.olive {
+ color: #606000
+}
+
+.olive-background {
+ background-color: #7d7d00
+}
+
+.purple {
+ color: #600060
+}
+
+.purple-background {
+ background-color: #7d007d
+}
+
+.red {
+ color: #bf0000
+}
+
+.red-background {
+ background-color: #fa0000
+}
+
+.silver {
+ color: #909090
+}
+
+.silver-background {
+ background-color: #bcbcbc
+}
+
+.teal {
+ color: #006060
+}
+
+.teal-background {
+ background-color: #007d7d
+}
+
+.white {
+ color: #bfbfbf
+}
+
+.white-background {
+ background-color: #fafafa
+}
+
+.yellow {
+ color: #bfbf00
+}
+
+.yellow-background {
+ background-color: #fafa00
+}
+
+span.icon>.fa {
+ cursor: default
+}
+
+a span.icon>.fa {
+ cursor: inherit
+}
+
+.admonitionblock td.icon [class^="fa icon-"] {
+ font-size: 2.5em;
+ text-shadow: 1px 1px 2px rgba(0, 0, 0, .5);
+ cursor: default
+}
+
+.admonitionblock td.icon .icon-note::before {
+ content: "\f05a";
+ color: #19407c
+}
+
+.admonitionblock td.icon .icon-tip::before {
+ content: "\f0eb";
+ text-shadow: 1px 1px 2px rgba(155, 155, 0, .8);
+ color: #111
+}
+
+.admonitionblock td.icon .icon-warning::before {
+ content: "\f071";
+ color: #bf6900
+}
+
+.admonitionblock td.icon .icon-caution::before {
+ content: "\f06d";
+ color: #bf3400
+}
+
+.admonitionblock td.icon .icon-important::before {
+ content: "\f06a";
+ color: #bf0000
+}
+
+.conum[data-value] {
+ display: inline-block;
+ color: #fff !important;
+ background-color: rgba(0, 0, 0, .8);
+ -webkit-border-radius: 100px;
+ border-radius: 100px;
+ text-align: center;
+ font-size: .75em;
+ width: 1.67em;
+ height: 1.67em;
+ line-height: 1.67em;
+ font-family: "Source Sans Pro", "DejaVu Sans", sans-serif;
+ font-style: normal;
+ font-weight: bold
+}
+
+.conum[data-value] * {
+ color: #fff !important
+}
+
+.conum[data-value]+b {
+ display: none
+}
+
+.conum[data-value]::after {
+ content: attr(data-value)
+}
+
+pre .conum[data-value] {
+ position: relative;
+ top: -.125em
+}
+
+b.conum * {
+ color: inherit !important
+}
+
+.conum:not([data-value]):empty {
+ display: none
+}
+
+dt,
+th.tableblock,
+td.content,
+div.footnote {
+ text-rendering: optimizeLegibility
+}
+
+h1,
+h2,
+p,
+td.content,
+span.alt {
+ letter-spacing: -.01em
+}
+
+p strong,
+td.content strong,
+div.footnote strong {
+ letter-spacing: -.005em
+}
+
+p,
+blockquote,
+dt,
+td.content,
+span.alt {
+ /*font-size: 1.0625rem*/
+}
+
+p {
+ margin-bottom: 1.25rem
+}
+
+.sidebarblock p,
+.sidebarblock dt,
+.sidebarblock td.content,
+p.tableblock {
+ font-size: 1em
+}
+
+.exampleblock>.content {
+ background-color: #fffef7;
+ border-color: #dddddd;
+ -webkit-box-shadow: 0 1px 4px #e0e0dc;
+ box-shadow: 0 1px 4px #e0e0dc
+}
+
+.print-only {
+ display: none !important
+}
+
+@page {
+ margin: 1.25cm .75cm
+}
+
+@media print {
+ * {
+ -webkit-box-shadow: none !important;
+ box-shadow: none !important;
+ text-shadow: none !important
+ }
+
+ html {
+ font-size: 80%
+ }
+
+ a {
+ color: inherit !important;
+ text-decoration: underline !important
+ }
+
+ a.bare,
+ a[href^="#"],
+ a[href^="mailto:"] {
+ text-decoration: none !important
+ }
+
+ a[href^="http:"]:not(.bare)::after,
+ a[href^="https:"]:not(.bare)::after {
+ content: "("attr(href) ")";
+ display: inline-block;
+ font-size: .875em;
+ padding-left: .25em
+ }
+
+ abbr[title]::after {
+ content: " ("attr(title) ")"
+ }
+
+ pre,
+ blockquote,
+ tr,
+ img,
+ object,
+ svg {
+ page-break-inside: avoid
+ }
+
+ thead {
+ display: table-header-group
+ }
+
+ svg {
+ max-width: 100%
+ }
+
+ p,
+ blockquote,
+ dt,
+ td.content {
+ font-size: 1em;
+ orphans: 3;
+ widows: 3
+ }
+
+ h2,
+ h3,
+ #toctitle,
+ .sidebarblock>.content>.title {
+ page-break-after: avoid
+ }
+
+ #toc,
+ .sidebarblock,
+ .exampleblock>.content {
+ background: none !important
+ }
+
+ #toc {
+ border-bottom: 1px solid #dddddd !important;
+ padding-bottom: 0 !important
+ }
+
+ body.book #header {
+ text-align: center
+ }
+
+ body.book #header>h1:first-child {
+ border: 0 !important;
+ margin: 2.5em 0 1em
+ }
+
+ body.book #header .details {
+ border: 0 !important;
+ display: block;
+ padding: 0 !important
+ }
+
+ body.book #header .details span:first-child {
+ margin-left: 0 !important
+ }
+
+ body.book #header .details br {
+ display: block
+ }
+
+ body.book #header .details br+span::before {
+ content: none !important
+ }
+
+ body.book #toc {
+ border: 0 !important;
+ text-align: left !important;
+ padding: 0 !important;
+ margin: 0 !important
+ }
+
+ body.book #toc,
+ body.book #preamble,
+ body.book h1.sect0,
+ body.book .sect1>h2 {
+ page-break-before: always
+ }
+
+ .listingblock code[data-lang]::before {
+ display: block
+ }
+
+ #footer {
+ padding: 0 .9375em
+ }
+
+ .hide-on-print {
+ display: none !important
+ }
+
+ .print-only {
+ display: block !important
+ }
+
+ .hide-for-print {
+ display: none !important
+ }
+
+ .show-for-print {
+ display: inherit !important
+ }
+
+}
+
+@media print, amzn-kf8 {
+ #header>h1:first-child {
+ margin-top: 1.25rem
+ }
+
+ .sect1 {
+ padding: 0 !important
+ }
+
+ .sect1+.sect1 {
+ border: 0
+ }
+
+ #footer {
+ background: none
+ }
+
+ #footer-text {
+ color: rgba(0, 0, 0, .6);
+ font-size: .9em
+ }
+
+}
+
+@media amzn-kf8 {
+ #header,
+ #content,
+ #footnotes,
+ #footer {
+ padding: 0
+ }
+
+}
+</style>
+<style>
+/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
+/*pre.CodeRay {background-color:#f7f7f8;}*/
+.CodeRay .line-numbers{border-right:1px solid #d8d8d8;padding:0 0.5em 0 .25em}
+.CodeRay span.line-numbers{display:inline-block;margin-right:.5em;color:rgba(0,0,0,.3)}
+.CodeRay .line-numbers strong{color:rgba(0,0,0,.4)}
+table.CodeRay{border-collapse:separate;border-spacing:0;margin-bottom:0;border:0;background:none}
+table.CodeRay td{vertical-align: top;line-height:1.45}
+table.CodeRay td.line-numbers{text-align:right}
+table.CodeRay td.line-numbers>pre{padding:0;color:rgba(0,0,0,.3)}
+table.CodeRay td.code{padding:0 0 0 .5em}
+table.CodeRay td.code>pre{padding:0}
+.CodeRay .debug{color:#fff !important;background:#000080 !important}
+.CodeRay .annotation{color:#007}
+.CodeRay .attribute-name{color:#000080}
+.CodeRay .attribute-value{color:#700}
+.CodeRay .binary{color:#509}
+.CodeRay .comment{color:#998;font-style:italic}
+.CodeRay .char{color:#04d}
+.CodeRay .char .content{color:#04d}
+.CodeRay .char .delimiter{color:#039}
+.CodeRay .class{color:#458;font-weight:bold}
+.CodeRay .complex{color:#a08}
+.CodeRay .constant,.CodeRay .predefined-constant{color:#008080}
+.CodeRay .color{color:#099}
+.CodeRay .class-variable{color:#369}
+.CodeRay .decorator{color:#b0b}
+.CodeRay .definition{color:#099}
+.CodeRay .delimiter{color:#000}
+.CodeRay .doc{color:#970}
+.CodeRay .doctype{color:#34b}
+.CodeRay .doc-string{color:#d42}
+.CodeRay .escape{color:#666}
+.CodeRay .entity{color:#800}
+.CodeRay .error{color:#808}
+.CodeRay .exception{color:inherit}
+.CodeRay .filename{color:#099}
+.CodeRay .function{color:#900;font-weight:bold}
+.CodeRay .global-variable{color:#008080}
+.CodeRay .hex{color:#058}
+.CodeRay .integer,.CodeRay .float{color:#099}
+.CodeRay .include{color:#555}
+.CodeRay .inline{color:#000}
+.CodeRay .inline .inline{background:#ccc}
+.CodeRay .inline .inline .inline{background:#bbb}
+.CodeRay .inline .inline-delimiter{color:#d14}
+.CodeRay .inline-delimiter{color:#d14}
+.CodeRay .important{color:#555;font-weight:bold}
+.CodeRay .interpreted{color:#b2b}
+.CodeRay .instance-variable{color:#008080}
+.CodeRay .label{color:#970}
+.CodeRay .local-variable{color:#963}
+.CodeRay .octal{color:#40e}
+.CodeRay .predefined{color:#369}
+.CodeRay .preprocessor{color:#579}
+.CodeRay .pseudo-class{color:#555}
+.CodeRay .directive{font-weight:bold}
+.CodeRay .type{font-weight:bold}
+.CodeRay .predefined-type{color:inherit}
+.CodeRay .reserved,.CodeRay .keyword {color:#000;font-weight:bold}
+.CodeRay .key{color:#808}
+.CodeRay .key .delimiter{color:#606}
+.CodeRay .key .char{color:#80f}
+.CodeRay .value{color:#088}
+.CodeRay .regexp .delimiter{color:#808}
+.CodeRay .regexp .content{color:#808}
+.CodeRay .regexp .modifier{color:#808}
+.CodeRay .regexp .char{color:#d14}
+.CodeRay .regexp .function{color:#404;font-weight:bold}
+.CodeRay .string{color:#d20}
+.CodeRay .string .string .string{background:#ffd0d0}
+.CodeRay .string .content{color:#d14}
+.CodeRay .string .char{color:#d14}
+.CodeRay .string .delimiter{color:#d14}
+.CodeRay .shell{color:#d14}
+.CodeRay .shell .delimiter{color:#d14}
+.CodeRay .symbol{color:#990073}
+.CodeRay .symbol .content{color:#a60}
+.CodeRay .symbol .delimiter{color:#630}
+.CodeRay .tag{color:#008080}
+.CodeRay .tag-special{color:#d70}
+.CodeRay .variable{color:#036}
+.CodeRay .insert{background:#afa}
+.CodeRay .delete{background:#faa}
+.CodeRay .change{color:#aaf;background:#007}
+.CodeRay .head{color:#f8f;background:#505}
+.CodeRay .insert .insert{color:#080}
+.CodeRay .delete .delete{color:#800}
+.CodeRay .change .change{color:#66f}
+.CodeRay .head .head{color:#f4f}
+</style>
+</head>
+<body class="article">
+<div id="header">
+<div id="toc" class="toc">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel2">
+<li><a href="#_appenders">Appenders</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div class="sect2">
+<h3 id="_appenders">Appenders</h3>
+<div class="paragraph">
+<p>Decanter appenders receive the data from the collectors, and store the data into a storage backend.</p>
+</div>
+<div class="sect3">
+<h4 id="_log">Log</h4>
+<div class="paragraph">
+<p>The Decanter Log Appender creates a log message for each event received from the collectors.</p>
+</div>
+<div class="paragraph">
+<p>The <code>decanter-appender-log</code> feature installs the log appender:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install decanter-appender-log</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The log appender doesn’t require any configuration.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_elasticsearch_kibana">Elasticsearch & Kibana</h4>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<div class="title">Warning</div>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>For production, we recommend to use a dedicated instance of Elasticsearch and Kibana. The following features are not recommended
+for production.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Decanter provides three appenders for Elasticsearch:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>decanter-appender-elasticsearch-rest (recommanded) is an appender which directly uses the Elasticsearch HTTP REST API. It’s compliant with any Elasticsearch version (1.x, 2.x, 5.x, 6.x).</p>
+</li>
+<li>
+<p>decanter-appender-elasticsearch-jest (deprecated) is an appender which directly uses the Elasticsearch HTTP REST API, working with any Elasticsearch version (1.x, 2.x, 5.x, 6.x).</p>
+</li>
+<li>
+<p>decanter-appender-elasticsearch-native-1.x is an appender which uses the Elasticsearch 1.x Java Client API. It’s compliant only with Elasticsearch 1.x versions.</p>
+</li>
+<li>
+<p>decanter-appender-elasticsearch-native-2.x is an appender which uses the Elasticsearch 2.x Java Client API. It’s compliant only with Elasticsearch 2.x versions.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>These appenders store the data (coming from the collectors) into an Elasticsearch node.
+They transformm the data as a json document, stored into Elasticsearch.</p>
+</div>
+<div class="sect4">
+<h5 id="_elasticsearch_5_x_6_x_rest_appender">Elasticsearch 5.x/6.x Rest Appender</h5>
+<div class="paragraph">
+<p>The Decanter Elasticsearch Rest appender uses the Elasticsearch Rest client provided since Elasticsearch 5.x. It can be use with Elasticsearch 5.x or 6.x versions.</p>
+</div>
+<div class="paragraph">
+<p>The <code>decanter-appender-elasticsearch-rest</code> feature installs this appender:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install decanter-appender-elasticsearch-rest</pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_elasticsearch_http_rest_jest_appender">Elasticsearch HTTP REST Jest appender</h5>
+<div class="paragraph">
+<p>The Decanter Elasticsearch HTTP REST API appender uses the Elasticsearch REST API. It works with any Elasticsearch version (1.x and 2.x).</p>
+</div>
+<div class="paragraph">
+<p>The <code>decanter-appender-elasticsearch-jest</code> feature installs this appender:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install decanter-appender-elasticsearch-jest</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This feature installs the appender and the <code>etc/org.apache.karaf.decanter.appender.elasticsearch.jest.cfg</code> configuration file
+containing:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>#########################################################
+# Decanter Elasticsearch HTTP Jest Appender Configuration
+#########################################################
+
+# HTTP address of the elasticsearch node
+# NB: the appender uses discovery via elasticsearch nodes API
+address=http://localhost:9200
+
+# Basic username and password authentication
+# username=user
+# password=password</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The file contains the Elasticsearch node location:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the <code>address</code> is the HTTP URL of the Elasticsearch node. Default is <code><a href="http://localhost:9200" class="bare">http://localhost:9200</a></code>.</p>
+</li>
+<li>
+<p>the <code>username</code> is the username used for authentication (optional)</p>
+</li>
+<li>
+<p>the <code>password</code> is the password used for authentication (optional)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_elasticsearch_1_x_native_appender">Elasticsearch 1.x Native appender</h5>
+<div class="paragraph">
+<p>The Elasticsearch 1.x Native appender uses the Elasticsearch 1.x Java Client API. It’s very specific to
+Elasticsearch 1.x versions, and can’t run with Elasticsearch 2.x.</p>
+</div>
+<div class="paragraph">
+<p>The <code>decanter-appender-elasticsearch-native-1.x</code> feature installs the elasticsearch appender:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install decanter-appender-elasticsearch-native-1.x</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This feature installs the elasticsearch appender, especially the <code>etc/org.apache.karaf.decanter.appender.elasticsearch.cfg</code>
+configuration file containing:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>################################################
+# Decanter Elasticsearch Appender Configuration
+################################################
+
+# Hostname of the elasticsearch instance
+host=localhost
+# Port number of the elasticsearch instance
+port=9300
+# Name of the elasticsearch cluster
+clusterName=elasticsearch</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This file contains the elasticsearch instance connection properties:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the <code>host</code> property contains the hostname (or IP address) of the Elasticsearch instance</p>
+</li>
+<li>
+<p>the <code>port</code> property contains the port number of the Elasticsearch instance</p>
+</li>
+<li>
+<p>the <code>clusterName</code> property contains the name of the Elasticsearch cluster where to send the data</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_elasticsearch_2_x_native_appender">Elasticsearch 2.x Native appender</h5>
+<div class="paragraph">
+<p>The Elasticsearch 2.x Native appender uses the Elasticsearch 2.x Java Client API. It’s very specific to
+Elasticsearch 2.x versions, and can’t run with Elasticsearch 1.x.</p>
+</div>
+<div class="paragraph">
+<p>The <code>decanter-appender-elasticsearch-native-2.x</code> feature installs the elasticsearch appender:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install decanter-appender-elasticsearch-native-2.x</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This feature installs the elasticsearch appender, especially the <code>etc/org.apache.karaf.decanter.appender.elasticsearch.cfg</code>
+configuration file containing:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>################################################
+# Decanter Elasticsearch Appender Configuration
+################################################
+
+# Hostname of the elasticsearch instance
+host=localhost
+# Port number of the elasticsearch instance
+port=9300
+# Name of the elasticsearch cluster
+clusterName=elasticsearch</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This file contains the elasticsearch instance connection properties:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the <code>host</code> property contains the hostname (or IP address) of the Elasticsearch instance</p>
+</li>
+<li>
+<p>the <code>port</code> property contains the port number of the Elasticsearch instance</p>
+</li>
+<li>
+<p>the <code>clusterName</code> property contains the name of the Elasticsearch cluster where to send the data</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_embedding_decanter_elasticsearch_1_x_and_2_x">Embedding Decanter Elasticsearch (1.x and 2.x)</h5>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<div class="title">Note</div>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>For a larger and shared production platform, we recommend to dedicate a Elasticsearch instance on its own JVM.
+It allows you some specific tuning for elasticsearch.
+Another acceptable configuration is to set up the Decanter embedded Elasticsearch instance as part (client) of a larger
+cluster.</p>
+</div>
+<div class="paragraph">
+<p>The following Decanter Elasticsearch embedded instance setup works perfectly fine for Karaf Decanter monitoring purpose,
+especially for the current Karaf instance.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>For convenience, Decanter provides <code>elasticsearch</code> feature starting an embedded Elasticsearch instance:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install elasticsearch</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Decanter provides versions of this feature, depending of the Elasticsearch version you want to use (1.x or 2.x).</p>
+</div>
+<div class="paragraph">
+<p>You can see the feature version available:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:version-list elasticsearch</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Thanks to this elasticsearch instance, by default, the decanter-appender-elasticsearch* appenders will send the data to this instance.</p>
+</div>
+<div class="paragraph">
+<p>The feature also installs the <code>etc/elasticsearch.yml</code> configuration file, different depending of the Elasticsearch version.</p>
+</div>
+<div class="paragraph">
+<p>For Elasticsearch 1.x:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>###############################################################################
+##################### Elasticsearch Decanter Configuration ####################
+###############################################################################
+
+# WARNING: change in this configuration file requires a refresh or restart of
+# the elasticsearch bundle
+
+################################### Cluster ###################################
+
+# Cluster name identifies your cluster for auto-discovery. If you're running
+# multiple clusters on the same network, make sure you're using unique names.
+#
+cluster.name: elasticsearch
+cluster.routing.schedule: 50ms
+
+
+#################################### Node #####################################
+
+# Node names are generated dynamically on startup, so you're relieved
+# from configuring them manually. You can tie this node to a specific name:
+#
+node.name: decanter
+
+# Every node can be configured to allow or deny being eligible as the master,
+# and to allow or deny to store the data.
+#
+# Allow this node to be eligible as a master node (enabled by default):
+#
+#node.master: true
+#
+# Allow this node to store data (enabled by default):
+#
+node.data: true
+
+# You can exploit these settings to design advanced cluster topologies.
+#
+# 1. You want this node to never become a master node, only to hold data.
+# This will be the "workhorse" of your cluster.
+#
+#node.master: false
+#node.data: true
+#
+# 2. You want this node to only serve as a master: to not store any data and
+# to have free resources. This will be the "coordinator" of your cluster.
+#
+#node.master: true
+#node.data: false
+#
+# 3. You want this node to be neither master nor data node, but
+# to act as a "search load balancer" (fetching data from nodes,
+# aggregating results, etc.)
+#
+#node.master: false
+#node.data: false
+
+# Use the Cluster Health API [http://localhost:9200/_cluster/health], the
+# Node Info API [http://localhost:9200/_nodes] or GUI tools
+# such as <http://www.elasticsearch.org/overview/marvel/>,
+# <http://github.com/karmi/elasticsearch-paramedic>,
+# <http://github.com/lukas-vlcek/bigdesk> and
+# <http://mobz.github.com/elasticsearch-head> to inspect the cluster state.
+
+# A node can have generic attributes associated with it, which can later be used
+# for customized shard allocation filtering, or allocation awareness. An attribute
+# is a simple key value pair, similar to node.key: value, here is an example:
+#
+#node.rack: rack314
+
+# By default, multiple nodes are allowed to start from the same installation location
+# to disable it, set the following:
+#node.max_local_storage_nodes: 1
+
+
+#################################### Index ####################################
+
+# You can set a number of options (such as shard/replica options, mapping
+# or analyzer definitions, translog settings, ...) for indices globally,
+# in this file.
+#
+# Note, that it makes more sense to configure index settings specifically for
+# a certain index, either when creating it or by using the index templates API.
+#
+# See <http://elasticsearch.org/guide/en/elasticsearch/reference/current/index-modules.html> and
+# <http://elasticsearch.org/guide/en/elasticsearch/reference/current/indices-create-index.html>
+# for more information.
+
+# Set the number of shards (splits) of an index (5 by default):
+#
+#index.number_of_shards: 5
+
+# Set the number of replicas (additional copies) of an index (1 by default):
+#
+#index.number_of_replicas: 1
+
+# Note, that for development on a local machine, with small indices, it usually
+# makes sense to "disable" the distributed features:
+#
+#index.number_of_shards: 1
+#index.number_of_replicas: 0
+
+# These settings directly affect the performance of index and search operations
+# in your cluster. Assuming you have enough machines to hold shards and
+# replicas, the rule of thumb is:
+#
+# 1. Having more *shards* enhances the _indexing_ performance and allows to
+# _distribute_ a big index across machines.
+# 2. Having more *replicas* enhances the _search_ performance and improves the
+# cluster _availability_.
+#
+# The "number_of_shards" is a one-time setting for an index.
+#
+# The "number_of_replicas" can be increased or decreased anytime,
+# by using the Index Update Settings API.
+#
+# Elasticsearch takes care about load balancing, relocating, gathering the
+# results from nodes, etc. Experiment with different settings to fine-tune
+# your setup.
+
+# Use the Index Status API (<http://localhost:9200/A/_status>) to inspect
+# the index status.
+
+
+#################################### Paths ####################################
+
+# Path to directory containing configuration (this file and logging.yml):
+#
+#path.conf: /path/to/conf
+
+# Path to directory where to store index data allocated for this node.
+#
+#path.data: /path/to/data
+#
+# Can optionally include more than one location, causing data to be striped across
+# the locations (a la RAID 0) on a file level, favouring locations with most free
+# space on creation. For example:
+#
+#path.data: /path/to/data1,/path/to/data2
+path.data: data
+
+# Path to temporary files:
+#
+#path.work: /path/to/work
+
+# Path to log files:
+#
+#path.logs: /path/to/logs
+
+# Path to where plugins are installed:
+#
+#path.plugins: /path/to/plugins
+path.plugins: ${karaf.home}/elasticsearch/plugins
+
+#################################### Plugin ###################################
+
+# If a plugin listed here is not installed for current node, the node will not start.
+#
+#plugin.mandatory: mapper-attachments,lang-groovy
+
+
+################################### Memory ####################################
+
+# Elasticsearch performs poorly when JVM starts swapping: you should ensure that
+# it _never_ swaps.
+#
+# Set this property to true to lock the memory:
+#
+#bootstrap.mlockall: true
+
+# Make sure that the ES_MIN_MEM and ES_MAX_MEM environment variables are set
+# to the same value, and that the machine has enough memory to allocate
+# for Elasticsearch, leaving enough memory for the operating system itself.
+#
+# You should also make sure that the Elasticsearch process is allowed to lock
+# the memory, eg. by using `ulimit -l unlimited`.
+
+
+############################## Network And HTTP ###############################
+
+# Elasticsearch, by default, binds itself to the 0.0.0.0 address, and listens
+# on port [9200-9300] for HTTP traffic and on port [9300-9400] for node-to-node
+# communication. (the range means that if the port is busy, it will automatically
+# try the next port).
+
+# Set the bind address specifically (IPv4 or IPv6):
+#
+#network.bind_host: 192.168.0.1
+
+# Set the address other nodes will use to communicate with this node. If not
+# set, it is automatically derived. It must point to an actual IP address.
+#
+#network.publish_host: 192.168.0.1
+
+# Set both 'bind_host' and 'publish_host':
+#
+#network.host: 192.168.0.1
+network.host: 127.0.0.1
+
+# Set a custom port for the node to node communication (9300 by default):
+#
+#transport.tcp.port: 9300
+
+# Enable compression for all communication between nodes (disabled by default):
+#
+#transport.tcp.compress: true
+
+# Set a custom port to listen for HTTP traffic:
+#
+#http.port: 9200
+
+# Set a custom allowed content length:
+#
+#http.max_content_length: 100mb
+
+# Enable HTTP:
+#
+http.enabled: true
+http.cors.enabled: true
+http.cors.allow-origin: /.*/
+
+
+################################### Gateway ###################################
+
+# The gateway allows for persisting the cluster state between full cluster
+# restarts. Every change to the state (such as adding an index) will be stored
+# in the gateway, and when the cluster starts up for the first time,
+# it will read its state from the gateway.
+
+# There are several types of gateway implementations. For more information, see
+# <http://elasticsearch.org/guide/en/elasticsearch/reference/current/modules-gateway.html>.
+
+# The default gateway type is the "local" gateway (recommended):
+#
+#gateway.type: local
+
+# Settings below control how and when to start the initial recovery process on
+# a full cluster restart (to reuse as much local data as possible when using shared
+# gateway).
+
+# Allow recovery process after N nodes in a cluster are up:
+#
+#gateway.recover_after_nodes: 1
+
+# Set the timeout to initiate the recovery process, once the N nodes
+# from previous setting are up (accepts time value):
+#
+#gateway.recover_after_time: 5m
+
+# Set how many nodes are expected in this cluster. Once these N nodes
+# are up (and recover_after_nodes is met), begin recovery process immediately
+# (without waiting for recover_after_time to expire):
+#
+#gateway.expected_nodes: 2
+
+
+############################# Recovery Throttling #############################
+
+# These settings allow to control the process of shards allocation between
+# nodes during initial recovery, replica allocation, rebalancing,
+# or when adding and removing nodes.
+
+# Set the number of concurrent recoveries happening on a node:
+#
+# 1. During the initial recovery
+#
+#cluster.routing.allocation.node_initial_primaries_recoveries: 4
+#
+# 2. During adding/removing nodes, rebalancing, etc
+#
+#cluster.routing.allocation.node_concurrent_recoveries: 2
+
+# Set to throttle throughput when recovering (eg. 100mb, by default 20mb):
+#
+#indices.recovery.max_bytes_per_sec: 20mb
+
+# Set to limit the number of open concurrent streams when
+# recovering a shard from a peer:
+#
+#indices.recovery.concurrent_streams: 5
+
+
+################################## Discovery ##################################
+
+# Discovery infrastructure ensures nodes can be found within a cluster
+# and master node is elected. Multicast discovery is the default.
+
+# Set to ensure a node sees N other master eligible nodes to be considered
+# operational within the cluster. This should be set to a quorum/majority of
+# the master-eligible nodes in the cluster.
+#
+#discovery.zen.minimum_master_nodes: 1
+
+# Set the time to wait for ping responses from other nodes when discovering.
+# Set this option to a higher value on a slow or congested network
+# to minimize discovery failures:
+#
+#discovery.zen.ping.timeout: 3s
+
+# For more information, see
+# <http://elasticsearch.org/guide/en/elasticsearch/reference/current/modules-discovery-zen.html>
+
+# Unicast discovery allows to explicitly control which nodes will be used
+# to discover the cluster. It can be used when multicast is not present,
+# or to restrict the cluster communication-wise.
+#
+# 1. Disable multicast discovery (enabled by default):
+#
+#discovery.zen.ping.multicast.enabled: false
+#
+# 2. Configure an initial list of master nodes in the cluster
+# to perform discovery when new nodes (master or data) are started:
+#
+#discovery.zen.ping.unicast.hosts: ["host1", "host2:port"]
+
+# EC2 discovery allows to use AWS EC2 API in order to perform discovery.
+#
+# You have to install the cloud-aws plugin for enabling the EC2 discovery.
+#
+# For more information, see
+# <http://elasticsearch.org/guide/en/elasticsearch/reference/current/modules-discovery-ec2.html>
+#
+# See <http://elasticsearch.org/tutorials/elasticsearch-on-ec2/>
+# for a step-by-step tutorial.
+
+# GCE discovery allows to use Google Compute Engine API in order to perform discovery.
+#
+# You have to install the cloud-gce plugin for enabling the GCE discovery.
+#
+# For more information, see <https://github.com/elasticsearch/elasticsearch-cloud-gce>.
+
+# Azure discovery allows to use Azure API in order to perform discovery.
+#
+# You have to install the cloud-azure plugin for enabling the Azure discovery.
+#
+# For more information, see <https://github.com/elasticsearch/elasticsearch-cloud-azure>.
+
+################################## Slow Log ##################################
+
+# Shard level query and fetch threshold logging.
+
+#index.search.slowlog.threshold.query.warn: 10s
+#index.search.slowlog.threshold.query.info: 5s
+#index.search.slowlog.threshold.query.debug: 2s
+#index.search.slowlog.threshold.query.trace: 500ms
+
+#index.search.slowlog.threshold.fetch.warn: 1s
+#index.search.slowlog.threshold.fetch.info: 800ms
+#index.search.slowlog.threshold.fetch.debug: 500ms
+#index.search.slowlog.threshold.fetch.trace: 200ms
+
+#index.indexing.slowlog.threshold.index.warn: 10s
+#index.indexing.slowlog.threshold.index.info: 5s
+#index.indexing.slowlog.threshold.index.debug: 2s
+#index.indexing.slowlog.threshold.index.trace: 500ms
+
+################################## GC Logging ################################
+
+#monitor.jvm.gc.young.warn: 1000ms
+#monitor.jvm.gc.young.info: 700ms
+#monitor.jvm.gc.young.debug: 400ms
+
+#monitor.jvm.gc.old.warn: 10s
+#monitor.jvm.gc.old.info: 5s
+#monitor.jvm.gc.old.debug: 2s
+
+################################## Security ################################
+
+# Uncomment if you want to enable JSONP as a valid return transport on the
+# http server. With this enabled, it may pose a security risk, so disabling
+# it unless you need it is recommended (it is disabled by default).
+#
+#http.jsonp.enable: true</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>For Elasticsearch 2.x:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre># ======================== Elasticsearch Configuration =========================
+#
+# NOTE: Elasticsearch comes with reasonable defaults for most settings.
+# Before you set out to tweak and tune the configuration, make sure you
+# understand what are you trying to accomplish and the consequences.
+#
+# The primary way of configuring a node is via this file. This template lists
+# the most important settings you may want to configure for a production cluster.
+#
+# Please see the documentation for further information on configuration options:
+# <http://www.elastic.co/guide/en/elasticsearch/reference/current/setup-configuration.html>
+#
+# ---------------------------------- Cluster -----------------------------------
+#
+# Use a descriptive name for your cluster:
+#
+cluster.name: elasticsearch
+#
+# ------------------------------------ Node ------------------------------------
+#
+# Use a descriptive name for the node:
+#
+node.name: decanter
+#
+# Add custom attributes to the node:
+#
+# node.rack: r1
+#
+# ----------------------------------- Paths ------------------------------------
+#
+# Path to directory where to store the data (separate multiple locations by comma):
+#
+# path.data: /path/to/data
+path.data: data
+path.home: data
+#
+# Path to log files:
+#
+# path.logs: /path/to/logs
+#
+# ----------------------------------- Memory -----------------------------------
+#
+# Lock the memory on startup:
+#
+# bootstrap.mlockall: true
+#
+# Make sure that the `ES_HEAP_SIZE` environment variable is set to about half the memory
+# available on the system and that the owner of the process is allowed to use this limit.
+#
+# Elasticsearch performs poorly when the system is swapping the memory.
+#
+# ---------------------------------- Network -----------------------------------
+#
+# Set the bind address to a specific IP (IPv4 or IPv6):
+#
+# network.host: 192.168.0.1
+#
+# Set a custom port for HTTP:
+#
+# http.port: 9200
+#
+# For more information, see the documentation at:
+# <http://www.elastic.co/guide/en/elasticsearch/reference/current/modules-network.html>
+#
+# --------------------------------- Discovery ----------------------------------
+#
+# Pass an initial list of hosts to perform discovery when new node is started:
+# The default list of hosts is ["127.0.0.1", "[::1]"]
+#
+# discovery.zen.ping.unicast.hosts: ["host1", "host2"]
+#
+# Prevent the "split brain" by configuring the majority of nodes (total number of nodes / 2 + 1):
+#
+# discovery.zen.minimum_master_nodes: 3
+#
+# For more information, see the documentation at:
+# <http://www.elastic.co/guide/en/elasticsearch/reference/current/modules-discovery.html>
+#
+# ---------------------------------- Gateway -----------------------------------
+#
+# Block initial recovery after a full cluster restart until N nodes are started:
+#
+# gateway.recover_after_nodes: 3
+#
+# For more information, see the documentation at:
+# <http://www.elastic.co/guide/en/elasticsearch/reference/current/modules-gateway.html>
+#
+# ---------------------------------- Various -----------------------------------
+#
+# Disable starting multiple nodes on a single system:
+#
+# node.max_local_storage_nodes: 1
+#
+# Require explicit names when deleting indices:
+#
+# action.destructive_requires_name: true</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>It’s a "standard" elasticsearch configuration file, allowing you to configure the embedded elasticsearch instance.</p>
+</div>
+<div class="paragraph">
+<p>Warning: if you change the <code>etc/elasticsearch.yml</code> file, you have to restart (with the <code>bundle:restart</code> command) the
+Decanter elasticsearch bundle in order to load the changes.</p>
+</div>
+<div class="paragraph">
+<p>The Decanter elasticsearch node also supports loading and override of the settings using a
+<code>etc/org.apache.karaf.decanter.elasticsearch.cfg</code> configuration file.
+This file is not provided by default, as it’s used for override of the default settings.</p>
+</div>
+<div class="paragraph">
+<p>You can override the following elasticsearch properties in this configuration file:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>cluster.name</code></p>
+</li>
+<li>
+<p><code>http.enabled</code></p>
+</li>
+<li>
+<p><code>node.data</code></p>
+</li>
+<li>
+<p><code>node.name</code></p>
+</li>
+<li>
+<p><code>node.master</code></p>
+</li>
+<li>
+<p><code>path.data</code></p>
+</li>
+<li>
+<p><code>network.host</code></p>
+</li>
+<li>
+<p><code>cluster.routing.schedule</code></p>
+</li>
+<li>
+<p><code>path.plugins</code></p>
+</li>
+<li>
+<p><code>http.cors.enabled</code></p>
+</li>
+<li>
+<p><code>http.cors.allow-origin</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The advantage of using this file is that the elasticsearch node is automatically restarted in order to reload the
+settings as soon as you change the cfg file.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_embedding_decanter_kibana_3_x_only_working_with_elasticsearch_1_x">Embedding Decanter Kibana 3.x (only working with Elasticsearch 1.x)</h5>
+<div class="paragraph">
+<p>In addition of the embedded elasticsearch 1.x instance, Decanter also provides an embedded Kibana 3.x instance, containing
+ready to use Decanter dashboards.</p>
+</div>
+<div class="paragraph">
+<p>The <code>kibana</code> feature installs the embedded kibana instance:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install kibana/3.1.1</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>By default, the kibana instance is available on <code><a href="http://host:8181/kibana" class="bare">http://host:8181/kibana</a></code>.</p>
+</div>
+<div class="paragraph">
+<p>The Decanter Kibana instance provides ready to use dashboards:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Karaf dashboard uses the data harvested by the default JMX collector, and the log collector. Especially, it provides
+details about the threads, memory, garbage collection, etc.</p>
+</li>
+<li>
+<p>Camel dashboard uses the data harvested by the default JMX collector, or the Camel (JMX) collector. It can also
+leverage the Camel Tracer collector. It provides details about routes processing time, the failed exchanges, etc. This
+dashboard requires some tuning (updating the queries to match the route IDs).</p>
+</li>
+<li>
+<p>ActiveMQ dashboard uses the data harvested by the default JMX collector, or the ActiveMQ (JMX) collector. It provides
+details about the pending queue, the system usage, etc.</p>
+</li>
+<li>
+<p>OperatingSystem dashboard uses the data harvested by the system collector. The default dashboard expects data containing
+the filesystem usage, and temperature data. It’s just a sample, you have to tune the system collector and adapt this
+dashboard accordingly.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can change these dashboards to add new panels, change the existing panels, etc.</p>
+</div>
+<div class="paragraph">
+<p>Of course, you can create your own dashboards, starting from blank or simple dashboards.</p>
+</div>
+<div class="paragraph">
+<p>By default, Decanter Kibana uses embedded elasticsearch instance. However, it’s possible to use a remote elasticsearch
+instance by providing the elasticsearch parameter on the URL like this for instance:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>http://localhost:8181/kibana?elasticsearch=http://localhost:9400</pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_embedding_decanter_kibana_4_x_only_working_with_elasticsearch_2_x">Embedding Decanter Kibana 4.x (only working with Elasticsearch 2.x)</h5>
+<div class="paragraph">
+<p>In addition of the embedded elasticsearch 2.x instance, Decanter also provides an embedded Kibana 4.x instance.</p>
+</div>
+<div class="paragraph">
+<p>The <code>kibana</code> feature installs the embedded kibana instance:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install kibana/4.1.2</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>By default, the kibana instance is available on <code><a href="http://host:8181/kibana" class="bare">http://host:8181/kibana</a></code>.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<div class="title">Note</div>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>Decanter Kibana 4 automatically detects collector features. Then, it automatically creates corresponding dashboards.</p>
+</div>
+<div class="paragraph">
+<p>However, you still have a complete control of the visualizations and dashboards. You can update the index to
+automatically include new fields and create your own visualizations and dashboards.</p>
+</div>
+<div class="paragraph">
+<p>The default dashboard displayed is the "System" dashboard, requiring the jmx collector.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_kibana_6_x">Kibana 6.x</h5>
+<div class="paragraph">
+<p>The <code>kibana</code> 6.x feature doesn’t really embeds Kibana like Kibana 3 or 4 features.</p>
+</div>
+<div class="paragraph">
+<p>However, it’s a convenient feature that download and starts a Kibana instance for you.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install kibana/6.1.1</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The Kibana instance is started in a dedicated JVM and bound to port 5601 by default. However, the Decanter Kibana feature creates a proxy servlet.</p>
+</div>
+<div class="paragraph">
+<p>So, as for other Kibana features, you can access Kibana using <code><a href="http://host:8181/kibana" class="bare">http://host:8181/kibana</a></code> in your browser.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<div class="title">Note</div>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>Decanter Kibana 6.x automatically detects collector features and installs the corresponding dashboards.</p>
+</div>
+<div class="paragraph">
+<p>However, in order to work, the only setup you have to do is to create an index pattern <code>*</code> with <code>default</code> as name (in the advanced settings).</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="_elasticsearch_head_console">Elasticsearch Head console</h5>
+<div class="paragraph">
+<p>In addition of the embedded elasticsearch instance, Decanter also provides a web console allowing you to monitor and
+manage your elasticsearch cluster. It’s a ready to use elastisearch-head console, directly embedded in Karaf.</p>
+</div>
+<div class="paragraph">
+<p>The <code>elasticsearch-head</code> feature installs the embedded elasticsearch-head web console, corresponding to the
+elasticsearch version you are using.</p>
+</div>
+<div class="paragraph">
+<p>We can install <code>elasticsearch-head</code> 1.x feature, working with elasticsearch 1.x:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install elasticsearch-head/1.7.3</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>or 2.x feature, working with elasticsearch 2.x:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install elasticsearch-head/2.2.0</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>By default, the elasticsearch-head web console is available on <code><a href="http://host:8181/elasticsearch-head" class="bare">http://host:8181/elasticsearch-head</a></code>.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_file">File</h4>
+<div class="paragraph">
+<p>The Decanter File appender stores the collected data in a CSV file.</p>
+</div>
+<div class="paragraph">
+<p>The <code>decanter-appender-file</code> feature installs the file appender:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install decanter-appender-file</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>By default, the file appender stores the collected data in <code>${karaf.data}/decanter</code> file. You can change the file where to store the data
+using the <code>filename</code> property in <code>etc/org.apache.karaf.decanter.appender.file.cfg</code> configuration file.</p>
+</div>
+<div class="paragraph">
+<p>You can also change the marshaller to use. By default, the marshaller used is the CSV one. But you can switch to the JSON one
+using the <code>marshaller.target</code> property in <code>etc/org.apache.karaf.decanter.appender.file.cfg</code> configuration file.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_jdbc">JDBC</h4>
+<div class="paragraph">
+<p>The Decanter JDBC appender allows your to store the data (coming from the collectors) into a database.</p>
+</div>
+<div class="paragraph">
+<p>The Decanter JDBC appender transforms the data as a json string. The appender stores the json string and the timestamp
+into the database.</p>
+</div>
+<div class="paragraph">
+<p>The <code>decanter-appender-jdbc</code> feature installs the jdbc appender:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install decanter-appender-jdbc</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This feature also installs the <code>etc/org.apache.karaf.decanter.appender.jdbc.cfg</code> configuration file:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>#######################################
+# Decanter JDBC Appender Configuration
+#######################################
+
+# Name of the JDBC datasource
+datasource.name=jdbc/decanter
+
+# Name of the table storing the collected data
+table.name=decanter
+
+# Dialect (type of the database)
+# The dialect is used to create the table
+# Supported dialects are: generic, derby, mysql
+# Instead of letting Decanter created the table, you can create the table by your own
+dialect=generic</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This configuration file allows you to specify the connection to the database:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the <code>datasource.name</code> property contains the name of the JDBC datasource to use to connect to the database. You can
+create this datasource using the Karaf <code>jdbc:create</code> command (provided by the <code>jdbc</code> feature).</p>
+</li>
+<li>
+<p>the <code>table.name</code> property contains the table name in the database. The Decanter JDBC appender automatically creates
+the table for you, but you can create the table by yourself. The table is simple and contains just two column:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>timestamp as INTEGER</p>
+</li>
+<li>
+<p>content as VARCHAR or CLOB</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>the <code>dialect</code> property allows you to specify the database type (generic, mysql, derby). This property is only used for
+the table creation.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_jms">JMS</h4>
+<div class="paragraph">
+<p>The Decanter JMS appender "forwards" the data (collected by the collectors) to a JMS broker.</p>
+</div>
+<div class="paragraph">
+<p>The appender sends a JMS Map message to the broker. The Map message contains the harvested data.</p>
+</div>
+<div class="paragraph">
+<p>The <code>decanter-appender-jms</code> feature installs the JMS appender:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install decanter-appender-jms</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This feature also installs the <code>etc/org.apache.karaf.decanter.appender.jms.cfg</code> configuration file containing:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>#####################################
+# Decanter JMS Appender Configuration
+#####################################
+
+# Name of the JMS connection factory
+connection.factory.name=jms/decanter
+
+# Name of the destination
+destination.name=decanter
+
+# Type of the destination (queue or topic)
+destination.type=queue
+
+# Connection username
+# username=
+
+# Connection password
+# password=</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This configuration file allows you to specify the connection properties to the JMS broker:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the <code>connection.factory.name</code> property specifies the JMS connection factory to use. You can create this JMS connection
+factory using the <code>jms:create</code> command (provided by the <code>jms</code> feature).</p>
+</li>
+<li>
+<p>the <code>destination.name</code> property specifies the JMS destination name where to send the data.</p>
+</li>
+<li>
+<p>the <code>destination.type</code> property specifies the JMS destination type (queue or topic).</p>
+</li>
+<li>
+<p>the <code>username</code> property is optional and specifies the username to connect to the destination.</p>
+</li>
+<li>
+<p>the <code>password</code> property is optional and specifies the username to connect to the destination.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_camel">Camel</h4>
+<div class="paragraph">
+<p>The Decanter Camel appender sends the data (collected by the collectors) to a Camel endpoint.</p>
+</div>
+<div class="paragraph">
+<p>It’s a very flexible appender, allowing you to use any Camel route to transform and forward the harvested data.</p>
+</div>
+<div class="paragraph">
+<p>The Camel appender creates a Camel exchange and set the "in" message body with a Map of the harvested data.
+The exchange is send to a Camel endpoint.</p>
+</div>
+<div class="paragraph">
+<p>The <code>decanter-appender-camel</code> feature installs the Camel appender:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install decanter-appender-camel</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This feature also installs the <code>etc/org.apache.karaf.decanter.appender.camel.cfg</code> configuration file containing:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>#
+# Decanter Camel appender configuration
+#
+
+# The destination.uri contains the URI of the Camel endpoint
+# where Decanter sends the collected data
+destination.uri=direct-vm:decanter</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This file allows you to specify the Camel endpoint where to send the data:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>the <code>destination.uri</code> property specifies the URI of the Camel endpoint where to send the data.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The Camel appender send an exchange. The "in" message body contains a Map of the harvested data.</p>
+</div>
+<div class="paragraph">
+<p>For instance, in this configuration file, you can specify:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>destination.uri=direct-vm:decanter</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>And you can deploy the following Camel route definition:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre><?xml version="1.0" encoding="UTF-8"?>
+<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">
+
+ <camelContext xmlns="http://camel.apache.org/schema/blueprint">
+ <route id="decanter">
+ <from uri="direct-vm:decanter"/>
+ ...
+ ANYTHING
+ ...
+ </route>
+ </camelContext>
+
+</blueprint></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This route will receive the Map of harvested data. Using the body of the "in" message, you can do what you want:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>transform and convert to another data format</p>
+</li>
+<li>
+<p>use any Camel EIPs (Enterprise Integration Patterns)</p>
+</li>
+<li>
+<p>send to any Camel endpoint</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_kafka">Kafka</h4>
+<div class="paragraph">
+<p>The Decanter Kafka appender sends the data (collected by the collectors) to a Kafka topic.</p>
+</div>
+<div class="paragraph">
+<p>The <code>decanter-appender-kafka</code> feature installs the Kafka appender:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>karaf@root()> feature:install decanter-appender-kafka</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This feature installs a default <code>etc/org.apache.karaf.decanter.appender.kafka.cfg</code> configuration file containing:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>##################################
+# Decanter JMS Kafka Configuration
+##################################
+
+# A list of host/port pairs to use for establishing the initial connection to the Kafka cluster
+#bootstrap.servers=localhost:9092
+
+# An id string to pass to the server when making requests
+# client.id
+
+# The compression type for all data generated by the producer
+# compression.type=none
+
+# The number of acknowledgments the producer requires the leader to have received before considering a request complete
+#Â - 0: the producer doesn't wait for ack
[... 732 lines stripped ...]