a601845780
This commit removes references to JMX from the docs. Context: The JMX server has been dropped and removed from installation. The user can install it manually if needed, as documented with https://github.com/scylladb/scylladb/issues/18687. This commit removes the outdated information about JMX from other pages in the documentation, including the docs for nodetool, the list of ports, and the admin section. Also, the no longer relevant JMX information is removed from the Docker Hub docs. Fixes https://github.com/scylladb/scylladb/issues/18687 Fixes https://github.com/scylladb/scylladb/issues/19575 Closes scylladb/scylladb#20917
79 lines
2.2 KiB
ReStructuredText
79 lines
2.2 KiB
ReStructuredText
Logging
|
|
=======
|
|
|
|
Logging with the systemd journal (CentOS, Amazon AMI, Ubuntu, Debian)
|
|
---------------------------------------------------------------------
|
|
On distributions with systemd, ScyllaDB logs are written to the `systemd journal <http://www.freedesktop.org/software/systemd/man/systemd-journald.service.html>`_. You can retrieve log entries with the `journalctl <http://www.freedesktop.org/software/systemd/man/journalctl.html>`_ command.
|
|
|
|
Listed below are a few useful examples.
|
|
|
|
* get logs generated by the "scylla" user:
|
|
|
|
.. code-block:: shell
|
|
|
|
journalctl _UID=`id -u scylla`
|
|
|
|
* get logs generated by the "scylla" command:
|
|
|
|
.. code-block:: shell
|
|
|
|
journalctl _COMM=scylla
|
|
|
|
* filter only ScyllaDB logs by priority:
|
|
|
|
.. code-block:: shell
|
|
|
|
journalctl _COMM=scylla -p err..emerg
|
|
|
|
.. code-block:: shell
|
|
|
|
journalctl _COMM=scylla -p warning
|
|
|
|
* filter only ScyllaDB logs by date:
|
|
|
|
.. code-block:: shell
|
|
|
|
journalctl _COMM=scylla --since="2013-3-16 23:59:59"
|
|
|
|
.. code-block:: shell
|
|
|
|
journalctl _COMM=scylla --since "2015-01-10" --until "2015-01-11 03:00"`
|
|
|
|
.. code-block:: shell
|
|
|
|
journalctl _COMM=scylla --since yesterday
|
|
|
|
* filter only ScyllaDB logs since last server boot:
|
|
|
|
.. code-block:: shell
|
|
|
|
journalctl _COMM=scylla -b
|
|
|
|
Logging on Ubuntu 14.04
|
|
-----------------------
|
|
On Ubuntu 14.04, ScyllaDB writes its initial boot message into :code:`/var/log/upstart/scylla-server.log`.
|
|
|
|
After ScyllaDB has started, logs are stored in :code:`/var/log/syslog`. ScyllaDB logs can be filter by creating a :code:`rsyslog` configuration file with the following rule (for example, in :code:`/etc/rsyslog.d/10-scylla.conf`)
|
|
|
|
.. code-block:: shell
|
|
|
|
:syslogtag, startswith, "scylla" /var/log/scylla/scylla.log
|
|
& ~
|
|
|
|
And then creating the log file with the correct permissions and restarting the service:
|
|
|
|
.. code-block:: shell
|
|
|
|
install -o syslog -g adm -m 0640 /dev/null /var/log/scylla/scylla.log
|
|
service rsyslog restart
|
|
|
|
This will send ScyllaDB only logs to :code:`/var/log/scylla/scylla.log`
|
|
|
|
Logging on Docker
|
|
-----------------
|
|
Starting from ScyllaDB 1.3, `ScyllaDB Docker <https://hub.docker.com/r/scylladb/scylla/>`_, you should use :code:`docker logs` command to access ScyllaDB server logs.
|
|
|
|
|
|
.. include:: /rst_include/advance-index.rst
|
|
|