Gentoo Archives: gentoo-commits

From: "Davide Cendron (scen)" <scen@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/proj/it/infrastructure/tenshi: index.xml
Date: Wed, 30 Jul 2008 19:21:10
Message-Id: E1KOHEQ-0005UK-Jc@stork.gentoo.org
1 scen 08/07/30 19:21:06
2
3 Added: index.xml
4 Log:
5 Initial commit: version 0.3.4, revision 1.6 of EN CVS
6
7 Revision Changes Path
8 1.1 xml/htdocs/proj/it/infrastructure/tenshi/index.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/infrastructure/tenshi/index.xml?rev=1.1&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/infrastructure/tenshi/index.xml?rev=1.1&content-type=text/plain
12
13 Index: index.xml
14 ===================================================================
15 <?xml version='1.0' encoding="UTF-8"?>
16 <?xml-stylesheet href="/xsl/guide.xsl" type="text/xsl"?>
17
18 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/infrastructure/tenshi/index.xml,v 1.1 2008/07/30 19:21:06 scen Exp $ -->
19
20 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
21
22 <guide link="/proj/it/infrastructure/tenshi/index.xml" lang="it">
23
24 <title>Documentazione Gentoo Linux -- Tenshi</title>
25
26 <author title="Autore">
27 <mail link="lcars@g.o">Andrea Barisani</mail>
28 </author>
29 <author title="Traduzione">
30 <mail link="scen"/>
31 </author>
32
33 <abstract>
34 Questa pagina introduce tenshi, uno strumento per il monitoraggio dei log e la
35 creazione di reportistica su di essi.
36 </abstract>
37
38 <version>0.3.4</version>
39 <date>2005-07-25</date>
40
41 <chapter>
42 <title>Introduzione</title>
43 <section>
44 <body>
45
46 <p>
47 Tenshi è un programma di monitoraggio dei log, progettato per controllare
48 all'interno di uno o più file di log di linee che combacino con espressioni
49 regolarti definite dall'utente e riportare le corrispondenze. Le espressioni
50 regolari vengono assegnate a delle code che hanno un intervallo di allerta e
51 una lista di destinatari di posta elettronica.
52 </p>
53
54 <p>
55 Le code possono essere impostate per inviare una notifica appena c'è una linea
56 di log assegnata ad essa, o inviare report periodici.
57 </p>
58
59 <p>
60 In aggiunta, i campi nelle linee di log che non interessano (come i numeri dei
61 PID) possono essere mascherati con gli operatori standard di raggruppamento ( )
62 delle espressioni regolari. Questo permette di ottenere dei report più puliti e
63 leggibili. Tutti i report sono suddivisi per nome host e tutti i messaggi sono
64 condensati quando possibile.
65 </p>
66
67 <p>
68 Il programma legge un file di configurazione e successivamente effettua il fork
69 di un demone per il monitoraggio degli specifici file di log.
70 </p>
71
72 <p>
73 Si prega di leggere il file <uri
74 link="http://www.gentoo.org/~lcars/tenshi/tenshi.conf">tenshi.conf</uri>
75 d'esempio e la pagina di manuale tenshi.8 per le istruzioni d'uso.<br/><br/>
76 </p>
77
78 <impo>
79 Questo pacchetto in precedenza era conosciuto come <c>Wasabi</c>, il nome è
80 stato cambiato a causa di problemi di violazioni di marchio di fabbrica.
81 </impo>
82
83 </body>
84 </section>
85 </chapter>
86
87 <chapter>
88 <title>Esempi</title>
89 <section>
90 <body>
91
92 <p>
93 Considerare le seguenti impostazioni in tenshi.conf:
94 </p>
95
96 <pre caption="impostazioni code in tenshi.conf">
97
98 ...
99
100 set hidepid on
101
102 set queue mail tenshi@localhost sysadmin@localhost [0 */12 * * *]
103 set queue misc tenshi@localhost sysadmin@localhost [0 */24 * * *]
104 set queue critical tenshi@localhost sysadmin@localhost [now]
105
106 group ^ipop3d:
107
108 mail ^ipop3d: Login user=(.+)
109 mail ^ipop3d: Logout user=(.+)
110 mail ^ipop3d: pop3s SSL service init from (.+)
111 mail ^ipop3d: pop3 service init from (.+)
112 mail ^ipop3d: Command stream end of file, while reading.+
113 mail ^ipop3d: Command stream end of file while reading.+
114
115 critical ^ipop3d: Login failed.+
116
117 trash ^ipop3d:.+
118
119 group_end
120
121 critical ^sudo: (.+) : TTY=(.+) ; PWD=(.+) ; USER=root ; COMMAND=(.+)
122
123 misc .*
124 </pre>
125
126 <p>
127 Ogni messaggio ipop3d che non corrisponde alle espressioni regolari assegnati
128 alla coda <e>mail</e> o critici che combaciano con la coda <e>thrash</e> (una
129 coda nulla interna), ogni altro messaggio corrisponderà alla coda <e>misc</e>.
130 I campi racchiusi in <c>(.+)</c> sono mascherati.
131 </p>
132
133 <p>
134 Questo è un report d'esempio per la coda <e>mail</e> (inviato ogni 12 ore):
135 </p>
136
137 <pre caption="Report d'esempio - coda [mail]">
138
139 host1:
140 79: ipop3d: Login user=___
141 74: ipop3d: Logout user=___
142
143 host2:
144 30: ipop3d: Login user=___
145 30: ipop3d: Logout user=___
146 19: ipop3d: pop3 service init from ___
147 12: ipop3d: pop3s SSL service init from ___
148 1: ipop3d: Command stream end of file while reading line user=??? host=bogus.domain.net [192.168.0.1]
149 1: ipop3d: Command stream end of file, while reading authentication host=bogus1.domain.net [10.1.7.1]
150 </pre>
151
152 <p>
153 Ecco dei report d'esempio per la coda <e>critical</e> (inviati ogni volta che
154 un messaggio corrisponde all'espressione regolare):
155 </p>
156
157 <pre caption="Report d'esempio - coda [critical]">
158 host1:
159 1: /usr/bin/sudo: ___ : TTY=___ ; PWD=___ ; USER=root ; COMMAND=/bin/dmesg
160 </pre>
161
162 <pre caption="Report d'esempio - coda [critical]">
163 host1:
164 1: /usr/bin/sudo: ___ : TTY=___ ; PWD=___ ; USER=root ; COMMAND=/bin/bash
165 </pre>
166
167 <pre caption="Report d'esempio - coda [critical]">
168 host2:
169 1: ipop3d: Login failed user=admin auth=admin host=bogus1.domain.net [10.1.7.1]
170 </pre>
171
172 <pre caption="Report d'esempio - coda [critical]">
173 host2:
174 1: ipop3d: Autologout user=??? host=bogus.domain.net [192.168.0.1]
175 </pre>
176
177 </body>
178 </section>
179 </chapter>
180
181 <chapter>
182 <title>Requisiti</title>
183 <section>
184 <body>
185
186 <p>
187 Tenshi richiede un'implementazione funzionante di 'tail', inoltre richiede il
188 modulo Net::SMTP per i report via mail che dovrebbe essere incluso nella
189 propria installazione di perl.
190 </p>
191
192 <p>
193 Gli utenti di Gentoo Linux possono semplicemente installare l'ebuild
194 <e>app-admin/tenshi</e>
195 </p>
196
197 </body>
198 </section>
199 </chapter>
200
201 <chapter>
202 <title>Risorse</title>
203 <section>
204 <body>
205
206 <p>
207 Il rilascio più recente di <c>tenshi</c> può essere scaricato all'indirizzo <uri
208 link="http://www.gentoo.org/~lcars/tenshi/tenshi-latest.tar.gz">tenshi-latest.tar.gz</uri>.
209 </p>
210
211 <p>
212 Tutti i rilasci sono disponibili all'indirizzo <uri>
213 http://www.gentoo.org/~lcars/tenshi</uri>.
214 </p>
215
216 <p>
217 Inviare richieste/suggerimenti/bug report a <mail>tenshi@g.o</mail>.
218 </p>
219
220 </body>
221 </section>
222 </chapter>
223
224 </guide>