tools:mrtg:mrtg.cfg [SNMP]

[]
[]

<tbody>
  <tr>
    <td width="100%"><p><a name="mrtgcfg" id="mrtgcfg">mrtg.cfg</a></p></td>
  </tr>
</tbody>

</table>

Общие правила записи: ключевое слово в начале строки до двоеточия; строка продолжения начинается с пробела; строки комментарии начинаются с #. Команды: <ul>

<li><strong>Include: <em>имя-файла</em></strong> </li>
<li><strong>WorkDir</strong>: <strong><em>имя-директории</em></strong> (задает размещение журнала,   рабочих файлов и генерируемых страниц, имеет приоритет над HtmlDir, ImageDir и   LogDir) </li>
<li><strong>HtmlDir: <em>имя-директории</em></strong> </li>
<li><strong>ImageDir: <em>имя-директории</em></strong> (обязательно под HtmlDir - страницы   генерируются в этом предположении) </li>
<li><strong>LogDir: <em>имя-директории</em></strong> </li>
<li><strong>Refresh</strong>: частота перерисовки в броузере (по умолчанию 300 секунд) </li>
<li><strong>RunAsDaemon:</strong> no | yes </li>
<li><strong>Interval</strong>: предполагаемый интервал запуска mrtg (по умолчанию 5 минут,   сам запуск обеспечивается внешними средствами, например, через cron или   RunAsDaemon) </li>
<li><strong>IconDir</strong>: директория, где хранятся иконки (если отличается от WorkDir) </li>
<li><strong>Forks:</strong> число (сколько параллельных процессов опроса запускать) </li>
<li><strong>WriteExpire:</strong>  no | yes (создавать файлы .meta для apache - в   .htaccess надо добавить &quot;MetaDir .&quot; и &quot;MetaFiles on&quot;; этот же эффект - тэг   Expiration - можно достичь с помощью mod_expire (см. htaccess.txt)) </li>
<li><strong>NoMib2:</strong> no | yes (не запрашивать sysUptime, sysName) </li>
<li><strong>LoadMIBs:</strong> список-файлов-через-запятую </li>
<li><strong>Language:</strong> язык-отчетов </li>
<li><strong>ThreshDir: <em>имя-директории-хранящей-информацию-о-превышении-лимитов</em></strong> </li>
<li><strong>LogFormat:</strong> rrdtool (формат журналов для rrdtool - динамическое   создание отчетов) </li>
<li><strong>LibAdd:</strong> адрес-библиотеки-rrdtool (RRDs.pm) </li>
<li><strong>PathAdd:</strong> адрес-rrdtool </li>
<li>для каждого контролируемого устройства - точнее, контролируемого параметра -   (обозначается как target, буквы преобразуются к строчным), создается отдельная   секция. При работе mrtg каждый <strong><em>target</em></strong> порождает файлы журнала   (<strong><em>target</em>.log</strong> и <strong><em>target</em>.old</strong>), картинки с графиками   (<strong><em>target</em>-day.gif</strong>, <strong><em>target</em>-week.gif</strong>, <strong><em>target</em>-month.gif</strong>, <strong><em>target</em>-year.gif</strong>) и html-страницу   (<strong><em>target</em>.html</strong>).
  <ul>
      <li><strong>Target</strong>[<strong><em>target</em></strong>]: <strong><em>порт</em>:<em>комьюнити</em>@<em>маршрутизатор</em></strong>[<strong>:<em>port</em></strong>[<strong>:<em>timeout</em></strong>[:<strong><em>retries</em></strong>[<strong>:<em>backoff</em></strong>[:2]]]]],   где
        <ul>
            <li>порт - номер интерфейса на маршрутизаторе (номер в некоей внутренней   таблице) </li>
          <li>комьюнити - community в смысле SNMP (пароль на чтение) </li>
          <li>маршрутизатор (имя или IP-адрес) (не любит точку в конце   имени) </li>
          <li>port - по умолчанию стандартный порт SNMP (UDP 161) </li>
          <li>timeout - 2 секунды </li>
          <li>retries - 5 раз </li>
          <li>backoff - во сколько раз увеличивать timeout при каждом повторе (по   умолчанию - 1) </li>
          <li>2 - означает использование 64-битных счетчиков (устройство должно   поддерживать SNMPv2c) <br />
            в таком формате действительно извлекается информация о   входном и выходном трафике. Если перед номер порта поставить знак &quot;минус&quot;, то   входной и выходной трафик меняется местами. Вместо номера порта можно явно   задать два номера OID (идентификатор объекта в MIB, например -   1.3.6.1.2.1.2.2.1.14.1 - счетчик входных ошибок на интерфейсе 1) через   амперсенд. Можно использовать символические имена OID (список смотри в   mibhelp.txt, например - ifInErrors.1). Номера интерфейсов могут меняться при   реконфигурации маршрутизатора, но можно вместо номера интерфейса (последнее   число в OID) записывать IP-адрес после косой черты. Интерфейсы также можно   задавать по описанию (ifDescr) - после обратной косой черты. Или имени (ifName)   - после диез. Или по физическому адресу (ifPhysAddress) - после восклицательного   знака (пример: 0a-0-f1-5-23-18). Или типу (?) - после   процента.</li>
        </ul>
      </li>
    <li><strong>Target[<em>target</em>]:</strong> внешняя-программа-с-параметрами-в-обратных-кавычках <br />
      программа должна   возвращать на стандартный вывод 4 строки
      <ul>
            <li>значение первой переменной (предполагается счетчик входных байт) </li>
        <li>значение второй переменной (предполагается счетчик выходных байт) </li>
        <li>текстовая строка, содержащая информацию о времени работы объекта после   включения (uptime) </li>
        <li>строка, указывающая имя объекта </li>
      </ul>
    </li>
    <li><strong>Target[<em>target</em>]:</strong> математическое выражение, составленное из   простых объектов, описанных ранее (необходимо использовать пробелы вокруг знаков   операций) </li>
    <li><strong>RouterUptime[<em>target</em>]: <em>комьюнити</em>@<em>маршрутизатор</em></strong> <br />
      откуда брать информацию об имени маршрутизатора и его времени работы для   составных target </li>
    <li><strong>MaxBytes[<em>target</em>]: <em>число</em></strong> <br />
      Значения обеих переменных,   которые больше этого числа, игнорируются. Используется также для построения   немасштабируемого графика. </li>
    <li><strong>MaxBytes1</strong> </li>
    <li><strong>MaxBytes2</strong> </li>
    <li><strong>Title[<em>target</em>]: <em>заголовок для html-страницы</em></strong> </li>
    <li><strong>PageTop[<em>target</em>]:</strong> текст, выдаваемый в верхней части   html-страницы (можно и нужно использовать html-разметку) </li>
    <li><strong>PageFoot[<em>target</em>]:</strong> </li>
    <li><strong>AddHead[<em>target</em>]:</strong> html-текст, вставляемый после TITLE внутри   HEAD </li>
    <li><strong>MaxAbs[<em>target</em>]: <em>число</em></strong> <br />
      если используется сжатие, то   возвращаемое значение может превосходить MaxByte. </li>
    <li><strong>Unscaled[<em>target</em>]: </strong>[<strong>d</strong>][<strong>w</strong>][<strong>m</strong>][<strong>y</strong>] <br />
      подавить масштабирование по вертикали для соответствующего графика (d- day,   w - week, m - month, y - year) </li>
    <li><strong>WithPeak[<em>target</em>]:</strong> [<strong>w</strong>][<strong>m</strong>][<strong>y</strong>] <br />
      показывать в недельном, месячном и годовом графиках не только средние, но и   пиковые значения </li>
    <li><strong>Supress[<em>target</em>]:</strong> [<strong>d</strong>][<strong>w</strong>][<strong>m</strong>][<strong>y</strong>] <br />
      подавить генерацию части графиков </li>
    <li><strong>Extension: </strong>суффикс-вместо-.html </li>
    <li><strong>Directory[<em>target</em>]: <em>имя-директории</em></strong> <br />
      складывать сюда   все файлы, относящиеся к указанному <em>target (</em> рекомендуется использовать   относительные имена) </li>
    <li><strong>XSize[<em>target</em>]: <em>число</em></strong> <br />
      число пикселов в графике по   горизонтали (от 20 до 600, по умолчанию 400). Расходуется еще немного места под   оформление. </li>
    <li><strong>YSize[<em>target</em>]: <em>число</em></strong> <br />
      число пикселов в графике по   умолчанию (от 20, по умолчанию 100). Расходуется еще немного места под   оформление. </li>
    <li><strong>XZoom[<em>target</em>]: <em>число</em></strong> <br />
      масштабировать пикселы по X,   гадость </li>
    <li><strong>YZoom[<em>target</em>]: <em>число</em></strong> <br />
      масштабировать пикселы по Y,   гадость </li>
    <li><strong>XScale[<em>target</em>]: <em>число</em></strong> <br />
      масштабировать график по X,   гадость </li>
    <li><strong>YScale[<em>target</em>]: <em>число</em></strong> <br />
      масштабировать график по Y,   гадость </li>
    <li><strong>YTics[<em>target</em>]: </strong>число-вертикальных-делений (4) </li>
    <li><strong>YTicsFactor[<em>target</em>]:</strong> коэффициент-значений-оси </li>
    <li><strong>Step[<em>target</em>]: <em>секунд</em></strong> <br />
      изменить шаг отображения (по   умолчанию 300 секунд) </li>
    <li><strong>Options[<em>target</em>]: <em>список-опций-через-запятую</em></strong>
          <ul>
            <li><strong>growright</strong> - время движется вправо (по умолчанию - влево) </li>
            <li><strong>bits</strong> - все числа умножать на 8 (то бишь мерить в битах, тексты   меняются соответственно) </li>
            <li><strong>perminute</strong> - все числа умножат на 60 (то бишь мерить в единицах за   минуту, тексты меняются соответственно) </li>
            <li><strong>perhour</strong> - все числа умножаются на 3600 (то бишь мерить в единицах за   час, тексты меняются соответственно) </li>
            <li><strong>noinfo</strong> - подавлять вывод информации об имени устройства и его времени   работы </li>
            <li><strong>nopercent</strong> - подавить вывод процентной информации </li>
            <li><strong>transparent</strong> - генерировать прозрачный фон картинки </li>
            <li><strong>integer</strong> - выдавать поясняющую информацию без точек </li>
            <li><strong>dorelpercent</strong> - отношение входного трафика к выходному (от 0% до 100%,   если входной больше, чем выходной, то будет показано 100%).  Требуется пятый   цвет. </li>
            <li><strong>gauge</strong> - интерпретировать полученные значения как абсолютные значения   (а не значения счетчика). Полезно для отображения таких параметров, как загрузка   процессора, дискового пространства и т.д. По умолчанию, mrtg трактует полученные   значения как увеличивающийся счетчик (т.е. отрисовывает разницу между предыдущим   и текущим значением, деленную на прошедший интервал времени). </li>
            <li><strong>absolute</strong> - используется для значений, которые сбрасываются при чтении   (т.е. разница не вычисляется, но значение делится на интервал времени) </li>
            <li><strong>unknaszero</strong> - трактовать неверные значения как 0, а не как повторение   предыдущего значения </li>
            <li><strong>withzeroes</strong> - учитывать нулевые значения при вычислении среднего   (ругается при запуске) </li>
          </ul>
    </li>
    <li><strong>kilo[<em>target</em>]: <em>число</em></strong> <br />
      что понимается под кило? по   умолчанию - 1000, но можно установить 1024 </li>
    <li><strong>kMG[<em>target</em>]: <em>список-префиксов-множителей</em></strong> <br />
      какими   буквами обозначать кило, мега и др. По умолчанию: &quot;,k,M,G,T,P&quot;. Пустая строка   подавляет генерацию префиксов вовсе. </li>
    <li><strong>Colours[<em>target</em>]: <em>Colour1</em>#<em>RRGGBB</em>,<em>Colour2</em>#<em>RRGGBB</em>,<em>Colour3</em>#<em>RRGGBB</em>,<em>Colour4</em>#<em>RRGGBB</em></strong> <br />
      определение цветовой схемы, где <strong><em>Coloursi</em></strong> - текстовое имя   цвета, помещаемое в легенду графика, <strong><em>RRGGBB</em></strong> - шестнадцатеричные   значения, определяющие RGB-цвет. Если используется <strong>dorelprocent</strong>, то   требуется определить пятый цвет. </li>
    <li><strong>Background[<em>target</em>]:</strong> <strong>#<em>RRGGBB</em></strong> <br />
      цвет фона </li>
    <li><strong>YLegend[<em>target</em>]: <em>текстовая-строка</em></strong> <br />
      по умолчанию:   &quot;Bits per second&quot; </li>
    <li><strong>ShortLegend[<em>target</em>]: <em>текстовая-строка</em></strong> <br />
      по умолчанию:   &quot;b/s&quot; </li>
    <li><strong>Legend1[<em>target</em>]:</strong> Incoming Traffic in Bits per Second </li>
    <li><strong>Legend2[<em>target</em>]: </strong>Outgoing Traffic in Bits per Second </li>
    <li><strong>Legend3[<em>target</em>]:</strong> Maximal 5 Minute Incoming Traffic </li>
    <li><strong>Legend4[<em>target</em>]:</strong> Maximal 5 Minute Outgoing Traffic </li>
    <li><strong>LegendI[<em>target</em>]:</strong> In: </li>
    <li><strong>LegendO[<em>target</em>]:</strong> Out: <br />
      строки легенды, описывающие   соответствующий цвет. Приведены значения по умолчанию. Если в качестве легенды   используется пустая строка, то и график не выводится. </li>
    <li><strong>Timezone[<em>target</em>]: <em>имя-TZ</em></strong> </li>
    <li><strong>Weekformat[<em>target</em>]: W | V | U </strong>(как получать номер недели:   strftime(%W) или %V или %U </li>
    <li><strong>SetEnv[<em>target</em>]:</strong> установка переменных окружения перед при   вызове внешних скриптов (target или threshold) в формате имя=&quot;значение&quot;. </li>
    <li><strong>ThreshMinI[<em>target</em>]: <em>минимально-допустимое-значение-первого-параметра</em></strong> </li>
    <li><strong>ThreshMaxI[<em>target</em>]: <em>максимально-допустимое-значение-первого-параметра</em></strong> </li>
    <li><strong>ThreshProgI[<em>target</em>]: <em>имя-программы</em></strong> <br />
      вызывается, если   нарушены допустимые значения. Передается три параметра: $router, предельное   значение, текущее значение. Вызывается при каждой проверке,   пока параметр не придет в норму - надо как-то обходить. </li>
    <li><strong>ThreshProgOKI[<em>target</em>]: <em>имя-программы</em></strong> <br />
      вызывается,   если значение первого параметра вернулось в норму </li>
    <li><strong>ThreshMinO</strong>, <strong>ThreshMaxO</strong>, <strong>ThreshProgO</strong>, and <strong>ThreshProgOKO</strong> - аналогично для второго параметра </li>
    <li><strong>ThreshDesc[<em>target</em>]:</strong> строка-передаваемая-программе-через-переменную-THRESH_DESC </li>
  </ul>
</li>
<li>специальные устройства (target):
  <ul>
      <li>^ - все значения ключей, определенных для него, добавляются перед значениями   ключей для дальнейших target </li>
    <li>$ - все значения ключей, определенных для него, добавляются после значения   ключей для дальнейших target </li>
    <li>_ - определяет значения ключей по умолчанию для дальнейших target </li>
    <li>NoSpaceChar: символ (использование данного символа в конце ^ или начале $   подавляет вставку пробела </li>
  </ul>
</li>

</ul> </html>

tools/mrtg/mrtg.cfg.txt · Последнее изменение: 2017/10/21 10:43 — 127.0.0.1