diff --git a/doc/source/admin/index.rst b/doc/source/admin/index.rst index 12766cf7bb..9d32034a49 100644 --- a/doc/source/admin/index.rst +++ b/doc/source/admin/index.rst @@ -9,3 +9,4 @@ telemetry-system-architecture telemetry-measurements + telemetry-troubleshooting-guide diff --git a/doc/source/admin/telemetry-troubleshooting-guide.rst b/doc/source/admin/telemetry-troubleshooting-guide.rst new file mode 100644 index 0000000000..f6dc78ee85 --- /dev/null +++ b/doc/source/admin/telemetry-troubleshooting-guide.rst @@ -0,0 +1,21 @@ +Troubleshoot Telemetry +~~~~~~~~~~~~~~~~~~~~~~ + +Logging in Telemetry +-------------------- + +The Telemetry service has similar log settings as the other OpenStack +services. Multiple options are available to change the target of +logging, the format of the log entries and the log levels. + +The log settings can be changed in ``ceilometer.conf``. The list of +configuration options are listed in the logging configuration options +table in the `Telemetry +section `__ +in the OpenStack Configuration Reference. + +By default ``stderr`` is used as standard output for the log messages. +It can be changed to either a log file or syslog. The ``debug`` and +``verbose`` options are also set to false in the default settings, the +default log levels of the corresponding modules can be found in the +table referred above.