Jan Ulrich Hasecke
2019-11-29 55fea1a5022f31568854cdad2a3fd63838c08bc2
source/referenz/logging/index.rst
@@ -1,26 +1,62 @@
===========
.. _kap-logging:
=======
Logging
===========
=======
          
.. _kap-traffic:
Traffic
-------
=======
Im :doc:`Web-Paket<../webpaket/index>` wird jeden Monat eine :doc:`Traffic-Log-Datei<traffic-log>` für den erzeugten Traffic erzeugt, die den Verbrauch eines jeden Tages pro Zeile enthält.
Der Traffic setzt sich aus HTTP-, FTP- und Mail-Traffic (POP3, IMAP) zusammen. Bei Überschreitung des gebuchten Traffics wird der :doc:`Paket-Admin<../benutzer/paket-admin>` automatisch per E-Mail informiert.
Der Traffic setzt sich aus HTTP-, FTP- und Mail-Traffic (POP3, IMAP) zusammen. Bei Überschreitung des gebuchten Traffics wird der :role:`Paket-Admin` automatisch per E-Mail informiert.
Der Traffic für einzelne :doc:`Benutzer<../benutzer/index>` innerhalb eines Pakets kann nicht beschränkt werden.
.. _kap-traffic-log:
Traffic-Log-File
================
Der im Web-Paket erzeugte Traffic wird dem Paket-Admin unter :file:`/home/pacs/xyz00/var/traffic-iptables-YYYY-MM.log` zugänglich gemacht.
Das Logfile hat folgenden Aufbau:
+----------+-------+-------------+------------+--------------+---------------+----------+--------------+----------+
| Datum    | Paket | Monatslimit | Tageslimit | Trafficsumme | IP-Adresse 1  |Traffic 1 | IP-Adresse 2 | Traffic 2|
+==========+=======+=============+============+==============+===============+==========+==============+==========+
|2012-08-01| xyz00 |  10240      | 341.333    |   89.367     | 83.223.79.125 | 89.367   |              | 0.000    |
+----------+-------+-------------+------------+--------------+---------------+----------+--------------+----------+
Die Bedeutung der einzelnen Spalten:
``Datum:``        Datum der Messung
``Paket:``        Name des Web-Pakets
``Monatslimit:``  Gebuchter Gesamttraffic pro Monat in Megabyte
``Tageslimit:``   Tägliches Traffic-Kontingent bei gleichmäßigem Verbrauch in Megabyte
``Trafficsumme:`` Gesamtsumme des angefallenen Traffics am angegebenen Tag in Megabyte
``IP-Adresse 1:`` Primäre IP-Adresse des Web-Pakets
``Traffic 1:``    Über die primäre IP-Adresse angefallener Traffic in Megabyte
``IP-Adresse 2:`` Sekundäre IP-Adresse des Web-Pakets
``Traffic 2:``    Über die sekundäre IP-Adresse angefallener Traffic in Megabyte
.. _kap-http-log:
HTTP-Log
--------
Das in kurzen Abständen aktualisierte Logfile ``web.log`` des Webservers steht im Paketverzeichnis ``/home/pacs/xyz00/var/`` dem Paket-Admin zur Verfügung.
Aus dem Logfile werden nach Ablauf des Tages einzelne Logfiles für alle abgerufenen :doc:`Domain- und Sub-Domains<../domain/index>` generiert und unter  ``/home/pacs/xyz00/var/web-www.example.org-YYYYMMDD-HHMI.log.gz`` gespeichert.
Diese Dateien werden 48 Tage archiviert und nach Ablauf dieser Frist automatisch gelöscht.  Das Error-Logfile ``web.err`` des Webservers steht unter ``/home/pacs/xyz00/var`` dem Paket-Admin zur Verfügung.
========
Inhalt:
.. toctree::
        :maxdepth: 1
        traffic-log
Das in kurzen Abständen aktualisierte Logfile :file:`web.log` des Webservers steht im Paketverzeichnis :file:`/home/pacs/xyz00/var/` dem Paket-Admin zur Verfügung.
Aus dem Logfile werden nach Ablauf des Tages einzelne Logfiles für alle abgerufenen Domains und Sub-Domains generiert und unter  :file:`/home/pacs/xyz00/var/web-www.example.org-YYYYMMDD-HHMI.log.gz` gespeichert.
Diese Dateien werden 48 Tage archiviert und nach Ablauf dieser Frist automatisch gelöscht.
Das Error-Logfile ``web.err`` des Webservers steht unter :file:`/home/pacs/xyz00/var` dem Paket-Admin zur Verfügung.