Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,059 of 9,059 pages
About the help in other languages
All help pages

logviewer.ini [TailSettings]

The settings of [TailSettings] in logviewer.ini: InitialBytes, MaxBytesPerPoll, PollInterval, MaxPollInterval, MaxLinesKept, WrapLines, ChunkCacheTTL, ChunkCacheMaxBytes

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/examples/ini-settings/logviewer/TailSettings.md

On this page

logviewer.ini [TailSettings]

The block [TailSettings] of settings/logviewer.ini, with 8 setting(s).

Never edit settings/logviewer.ini itself: an update replaces it. Put the settings you change in an override, which wins over the shipped file:

  • settings/override/logviewer.ini.append.php for every siteaccess,
  • settings/siteaccess/<siteaccess>/logviewer.ini.append.php for one siteaccess,
  • extension/<extension>/settings/logviewer.ini.append.php in an extension (read when the extension is active).

InitialBytes

How much of a file the page shows when it is opened: the last InitialBytes bytes, from the first whole line.

Default: 65536.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[TailSettings]
InitialBytes=65536
*/ ?>

MaxBytesPerPoll

The most bytes one poll reads (a file that grew more than that is caught up over the next polls).

Default: 262144.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[TailSettings]
MaxBytesPerPoll=262144
*/ ?>

PollInterval

The poll interval of the page in milliseconds, while lines arrive.

Default: 1000.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[TailSettings]
PollInterval=1000
*/ ?>

MaxPollInterval

While nothing arrives the interval doubles after each empty poll, up to MaxPollInterval milliseconds.

Default: 15000.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[TailSettings]
MaxPollInterval=15000
*/ ?>

MaxLinesKept

The most lines the page keeps (older lines are dropped from the page, never from the file).

Default: 5000.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[TailSettings]
MaxLinesKept=5000
*/ ?>

WrapLines

Whether long lines are wrapped for a viewer who has not chosen yet. The page's "Wrap lines" switch stores each
viewer's choice as the user preference admin_logviewer_wrap (1 or 0), kept for every log and every visit.
enabled | disabled

Default: enabled.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[TailSettings]
WrapLines=enabled
*/ ?>

ChunkCacheTTL

The server keeps the last chunk read of each file for this many seconds, so several viewers of the same file,
and a poll whose file has not changed, are answered without opening it. 0 switches the cache off.

Default: 10.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[TailSettings]
ChunkCacheTTL=10
*/ ?>

ChunkCacheMaxBytes

The most bytes of a chunk the cache keeps.

Default: 262144.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[TailSettings]
ChunkCacheMaxBytes=262144
*/ ?>

Generated by ./console exp:help:examples from settings/logviewer.ini. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x