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> |