From 47c6f9561b95805d8abc8b33b81fe56b07b0a164 Mon Sep 17 00:00:00 2001 From: Aaron Bach Date: Sat, 13 Jul 2019 07:10:30 -0600 Subject: [PATCH] Add Apache Kafka docs (#9836) * Add Apache Kafka docs * :penil2: Cleaned up front matter --- source/_components/apache_kafka.markdown | 60 ++++++++++++++++++ .../images/supported_brands/apache_kafka.png | Bin 0 -> 8153 bytes 2 files changed, 60 insertions(+) create mode 100644 source/_components/apache_kafka.markdown create mode 100644 source/images/supported_brands/apache_kafka.png diff --git a/source/_components/apache_kafka.markdown b/source/_components/apache_kafka.markdown new file mode 100644 index 00000000000..7169c51bd3e --- /dev/null +++ b/source/_components/apache_kafka.markdown @@ -0,0 +1,60 @@ +--- +title: "Apache Kafka" +description: "Send data and events to Apache Kafka." +logo: apache_kafka.png +ha_category: + - History +ha_release: 0.97 +--- + +The `apache_kafka` integration sends all state changes to a +[Apache Kafka](https://kafka.apache.org/) topic. + +Apache Kafka is a real-time data pipeline that can read and write streams of data. It +stores its data safely in a distributed, replicated, fault-tolerant cluster. + +To use the `apache_kafka` integration in your installation, add the following to your +`configuration.yaml` file: + +```yaml +apache_kafka: + ip_address: localhost + port: 9092 + topic: home_assistant_1 +``` + +{% configuration %} +host: + description: The IP address or hostname of an Apache Kafka cluster. + required: true + type: string +port: + description: The port to use. + required: true + type: integer +topic: + description: The Kafka topic to send data to. + required: true + type: string +filter: + description: Filters for entities to be included/excluded. + required: false + type: map + keys: + include_domains: + description: Domains to be included. + required: false + type: list + include_entities: + description: Entities to be included. + required: false + type: list + exclude_domains: + description: Domains to be excluded. + required: false + type: list + exclude_entities: + description: Entities to be excluded. + required: false + type: list +{% endconfiguration %} diff --git a/source/images/supported_brands/apache_kafka.png b/source/images/supported_brands/apache_kafka.png new file mode 100644 index 0000000000000000000000000000000000000000..6e22be0279c1615be35e363f555a6fc648b6275c GIT binary patch literal 8153 zcmXw82Rzho{6ESlyMf58q>ypOAv+@^TW3d{?Xo$m97;xu(4olQ&gRGoS$862yJW9~ zLr4CP-~a!Az3%n8?|q-o^Vy%z^W5kC+|WRq=`7b-2n51(SLco~1VW8~K&ZIrX~7%Q zh2L)=5WWw0@2HsujjvC6Ca>yLMUx`=>7UyF-^an8KIZ>Fh(z<=x+(wFp=3oV!R@e- z!K8*E-=?dGn{|JN7y&!sM|*qenPsoEsUeULHMC_1n>B~HTM^|GGpj_ovelW@=A%t= zMEMi#GZ4t{bQyh~2-YtxD4V(p*+0*yAP{9aueL%zeu`*8zg7|#1oHWq!RdOwDtX#} zMqNOF2?Am5xfxTHqz;x;1DUNj|DOMC8EbYuTo3{oi2C*q{`lZ}Tg@#U`-1Zjh_t)S zlS?&qYgo-wis1@?ApII#7^TSJNxV-FfmpJ+4jy}#rDdH1O#A3vfbOTE)POI4D%$|~ z5vM54+sFIj^n(tdDgM0zy)*Isa1{$6pm&#O)#%N!MuZ1|t-}pi`_4lscpCZcDuL=# zaSQ^o(SsAng^ATWY=D!|PKCm@;;4=hcxDUYb#D3BG-6vcraax_FixGbcNrE!1lIUt z4?L|TTYvAB`nIumLFA3Ef|vJJ8l2q=6fW#5j=l_#{*SI*=xcRzFhF&aiifKKzLo#+oaSi5j$&p>jF@G)~Sk2rW2V$1>~oKo#I%2%=*ol zHxA4^lnf9mju$nfy`LU5$Qzl0y|IHheWL{g8v)4I<#6|Pa$Ke;7=jfDDV_py0gV-k zIo8d(s0#xsp|N(b^MDepJ-i3L)cX{5`R;Z+1&^~1lC^{OA|TQO9x%%J*-Rn)B?#oJ zn>f7`rDyLGtOZ2lbM()G9N&3VBR5^vDM;j(fAnRQgSft@sD}T{$R8Aub*D*h>)A`M zOaLj4tV_+?>qBjf8Ts*@*E|h@1R3`!qWXr%<)_+3n}Hi3fpSLmaJeX+*D<}j3P%6y zLV-4IRc_6Qy+`T6&PKH~z~BsHva(VPT|PcyTkTM8MwlIBxKKw?f8FS~#@@t3LdMWc zjsf(ylME|pW42-=X1KTv3?kht(1I`2|Y@fy}&mXdFVO zfn2|G2&5;rw_jcwt&?h_Z@)8=jIOh9^FSPxJX13A2NW@J z!d>)7zv@5g;N(_k1}AKNpk^RGp7mcV4DHv`6i$bRm)@%S8eRZQSiZ+z$FY7+no*yJ z7P~kD!U}sJN;oWBLMV}CF$d&v6C2QBBs~O5&F_zMg)GbxT{do~D&av96tJoj7NAM4 zHfLbhf^SW??ba$~wUgsB%Yzw)I2<2?gqY&2vq#qYv}Y!Lu4GPf8dq_bohcOwuk!p_ zab#didUaAtPxsevcJys0-+oFQ3vZ=&kj*-Xf(}zbBLAk?$u5};QZn^bnysYjne+Hk zoKNZ$jdgpAcvHq8(D|Wt)M8X88I%puJjyL~U~aMp&PiZ41-VU+m?o!0bcLA_XOeG% zq$BmcUnvmU>|iVE_oXWW4n||wJ}y|3lmj}SgJo92>sV~tc)CtG=k#r3G0?p*!D;%~ zHV?6!%3P59XzUl#8b3X>CQEJkh`3?Oa3TS|A@{RV8_SQRUK%C*LrrhaH8wY-Qd6-K z;)KHr_HTSvN*J;A=7+TMlVRQm`7d(+TT_q0Ui%uxMrb*vylV_-R(|=tI_$weawy3H zKW1IeOO1x&;Xf$eyDfsTKc0`$y-s5|T{RPf?MQtJ7}Fz8v*0f&$X#T1LPH~wTF(S9 zY=lUT5{g1mV#pN?6&k9}NQy_&9)5OdyfRIXfRIG}o~1=ij%LiN!A{94wkbYA(y|f; z(O7!Qp>X0SL9qSh&|hW4K5?)+(axeZBdKB|2`bdMIJhldMz!H89<wwNXNyakvFn}sc zdl{u<+MK2Kd%~8xj0Fv?*4?_rkD;PTu%fA#xA;!vqKr8(Ca>R7t4@IG{&{WQPo2J-lbB1=D!({e8dk0xMsw&vCu& z!OJU{kFKcVp@h=(H?_Xu0Y#{-)biX(`#;}uBlt>^F8q2oEk8i0?J=A!AsqPY3MRKh4T#14)NH0 zpQza^31=gy!a!oEWGk2#)U0+wg?%yT`(R;?$C8{Vi@(wSdc|1Z+$2085uGjI@Tz&^`A%w*l-kw&4SpM~cQZ}VnPQc25!4Z2B7!v>J*1 zry8((M>IxHSA8exHwfzU^jRvL4-&%o^AO(R3|8z%dZ=qDLzEsdOmNE=11hd|OByYi zx((d)Q}=oG&?>DY!jdq?XM*^F<2(g( z4=e28DUsNDwl4*LsZBJXT@|)^1>=-qJn++bc~dO&Wow<1xuoqWxp><%$E-`4*HP;d zixl!tMX!h6($$=VDq3vr7A@&O{v2VP8F3ohQnrkvTiz0UKK*R7bTjhr={G?8amGwCyKv&j&R%7CH5-QCv6r%-%3__%niE|?C*m@BIijXXvU{i zE#BqnWB#7+v+3#IgA;P&*N)}0m*sbcDPFy`$C$%Pu%t(%Erx6q=sC?y$ZbYEL~3ts z!!EIkV{V`ZhTA;O{C2>3KAFXd{OvydVpcBgTY#oRnd?&a*R(_sQ@=y~~KcxmM<|CM1k>zdEZwMmg zu;dtzIn?3u1^X;AZV!2lbZ?>@3pmzev1@G}Qmx{C^VxX~K02UUm=Hag?n#RaH458; z%~@?L_mfhac~{1KOoW!lA{$Bi2Q{lQ<%5oiy<^K)u+DR;uwo9v+qS-(j7!}6un?3= zO&*WFtp+u`mbm{_eyo=jjop-e)N}EnZJRzw=kgskGeDtP=y zKS4}QsC@ckw~tA9N0r0*8hn~ms?FuBcYoRk9WxC|f9u0uuo2!0ga(M_uRQEaH_0Ir z_;lYCskwL#Qm)?eQ%ykT{T;+9wCHrjM8OjxwP4%84*LaphhYu67{vWrJy>sjbPVDh zl*A~5hcmQ!BnLZLeL10HK#1wz2&$L)qg*&-b|!1sJb zJP@CDALf1|wNOFai{1BK>=+dD4GPX1K9Yyml4jBP!UAW#M?oD~0CRwb4&UzP(ugcd z!reeBnP%aXg8hcsK+k^0MlfwF8Dag9ZS?GK&Bm|y4Um0Mi1eBGppZ0 zH4`aI7p#@5BGmQC>6!+ShE&qe^jhz@Z1j`A;nu62EUB{F)zXv!8ebT z6RSg&=jZ(`@sB!8Z_tooM>$Nq{kInHj@zYQz3#YepvZ^pt?nBN42bRJ|SMI`I za1*loXIi8~>;!u272+SQC~=pzdbzO@q(Z08fjHx0usYi+dMQm;HrI*0`)h_3RUXBU z1A^G2sDknEx9?oKW3bWZ_305|(O6-Pt#7?HCM1uFmKbg2s=DwH0p(SBjB>*O0=V`)|H6AujnEDsuX+ z3i>74aTT@Zs_@hGFp&BLFbUbUH6yVS#WKe=dpGA+%-(;aP7jnoF^ltV2RaXVzxgvf z@a@%0a~Vvba%0|EBEoH!H(Qwjq*$Q2WLCq-A@;R)tW%b4MNsnN4z*09Ch0ESwzYMO zc7q+`k}z*?ky-VV!{3xiBOyUjPmUb>#VOZMT#%&CO)$;ilUc}04%c%084|Q5Iv4lw zW%)uy&@l|P&5b|u(h>VMz_g$kdY~JXdGHleLMquA^(qy3KKRC)_`FwlIVKaC$AXA* z)skvfkgj2HU>9ZLh!>2ju;8FkJ%N#$SYdt|OTqcZPPG|hf; z1~})XiLXf>>u>%0I*7_!k)b@kl+-M9ii0WvNe;PYAp94iKngZ$>GxHXY%YVUt>|yrvls$Uiqb5 zDZ(LkbMNr?<-gN7B@>v*h^LcdQMwn~wL|EDdPqz`>jS88+H0(Qwq{t1#?41!BkCK>AQvEhhT3j z8K=LFSdR-7I0?5Ef0YO*YF`)IR_ncvksiEMG0oS8#&VMS^y}g*WsdbT=-g102T<&} zuamN4)GDb*efc_@_&)`YUcti?kz`KKZYllxK+$53Hl=vAD*Y`fWh<4BCBJ?gwfxjO zuq@yY+NHfU(xQ`WZI*wL+i~Q_!eaIC42i>krim^cnIeKoTQ)ZmiCMuZUiPw@*mi5+ ztlP8x6peZ<)q*8oZ?QvbK&RW$QL~z%92R##30$-A-xT4BN%yrcx5}`r9gx8_kS8Jn ztLsJT&mbg0>LVUV9(y2mCl+qOd&WxS84vT7Zz70&e*d|)o%ad7b~TU#Bn3BvN`5HW=rw|;2uGb zFzc;#_?H%PIvQ#I)uqAQ@22^qBeWa!(o!g25p5V^JHzfbjEJE zeQaAVyb@M?t&F_+WWHv-r1axw`EETllB`s8@N)60llWkb_~iS$uwHQ4$q^|!K!|Nd zg>W>V&lgTGD#eA5s0LIAalgOG)tdYBNH`|742>;Hw%)BW+j&;YHNeX!jK(U125YKb za||!0^31A^Z~g9G?IDgCWcuqV!jJ8kcD4P+WK9Xbc<~L=y!>@B7wvE;euR2_`;hVNSF#+VQ1!q{X>=+EdrrkUo%>?5N7hi-y{Hd9k0>@)3<&2&F*`zbYhd-{ zgh#X7uRE|+MNC?SezELf=9>uN3@+h0G!{bgVD_<-yMn1Y79Dj(~UTHoY%vrCr25(t9CL&Yh-fCngZ>4D$aK0&$QPg(ZfBJ zGA=}6h*x4*&1l`>*u_vnTxX!pgFL-=j^2t!N|!S>9e=DuTX>I;*;=W}U5)TQPq-P4 zrPt<3cpCTJ4W`lex%ooL`@K>D*n>5u$|u4xVlbXkYnG$!&Ye?9smQ#R8J$Hp<-Vs# z+V6)yf=<^uq1x<}>k0RdtrMo{KFlZO9hn?8hWcdGMl9HOhvd^E9t+EoOO6 zmSEry+dky_>T{th5Oqm+h8XSk-`w&A7}BT5W{H?jT`mNpa#q6a8?{$q7WGNr{%kY= z5P%+WtX=alKd`_^?1{6~bug=hS`^J8N1pFAU2U~0#ZH4cENRWAs9$^(nX?g`ey`4G z_Q`)E(GuGEt&8re+~;Yr=?vUJ{vydk>gZ$HwXA;ozuN;p)Bz{}30IU?-tK96-=XMo zpoAToQ7{3c_1|({3BMb6H41|*lAzU9G&N(P%%NfE>MT)q&dVC`w~hq>6zRG0vXJ|L z!hR?3DzQW4u$ieU3Hmj&d{@p=zfO}D=L|42S&syqo72xgp-ye@okd-u(4b~HfGL>W zVygDIj=ySTT7cZ`H|2mp{DijoiYVP~pCy-|t1_t>g;EfRONmBmk>hh+;@ubZ-&|u5 z`TJs8Ma&S$d}%Qxhnx~N@`8Ptv1`|R*)!U9N<9 zY|m&%4ViV5ZOtr{d6}ScNDYI{c^qjipJ@LR1-7E~W>Hv<~CjNZw!+UZ5VFH#h8ulYHYEI5_kF zK-t{m&g?&_h37RvMh2NMxrTV%mE_iV4~%AeQ6qV^fGa&i7=VkP-#EWa+VkT` z{n3KJrMGLUwSS1#zhn3hQZnk3Q?zKwAH*U06agzQ^2jv#d|U$pxc*iOZB*YQ(G&O; zjWyiHg6TGdKX*_><{kf@zgVapT^v~A$2_(>!2?FV{GLfe0(C)^;m4l;?-QdtkjLt9 zdE>};Dnbd4sSYaIqz_%Xje>-{cR{6!C$cGzIV{BD7V?s zw&t~V;_{ouC4QmY0lFBY2HL!weeZ+{J5a7mlWVL&ybLr89RFGXWcw;O@UNnF8~|_% z?oFY{wb$3HX=;*UZeOS5*R8MZ2Yz!0obag`8iwE9KM4cVgm0sWg0|XmK#OOOR$!@> z>gR!He^qix{j6Ec2Y3-%DNY;5ZMqAy0$3=JsG?vrBbENc~7fz=4{*Rn(7Q21oZFIk7+&RgZP5_y32aOHufK Ys<3&>3Ty$i8UneiX>g}Z-TvwS0JO?