tpaexec archive-logs
====================

ログディレクトリを作成し、インスタンスからログをアーカイブするには、次のコマンドを実行します。

.. code:: bash

   tpaexec archive-logs <cluster-dir>

これにより、クラスターディレクトリにlogs/YYYYMMDDHHMMss/ディレクトリが作成され、クラスター内の各インスタンスの/var/logの下のすべてのファイルのtar.gzアーカイブが別のディレクトリにダウンロードされます。

前提条件
--------

既存のクラスターがある場合は、\ ``tpaexec archive-logs``
をすぐに実行できます。ただし、新しいクラスターを構成する場合は、少なくともクラスターを :ref:`tpaexec provision <tpaexec provision>` する必要があります。クラスターを :ref:`tpaexec deploy <tpaexec deploy>` する場合、より多くのログを取得します。

クイックスタート
----------------

.. code:: bash

   [tpa]$ tpaexec archive-logs ~/clusters/speedy

   PLAY [Prepare local host archive]  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  *** 

   TASK [Collect facts]  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  **** 
   ok: [localhost]

   TASK [Set time stamp]  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  *** 
   ok: [localhost]

   TASK [Create local log archive directory]  ****  ****  ****  ****  ****  ****  ****  ****  *** 
   changed: [localhost]

   PLAY [Archive log files from target instances]  ****  ****  ****  ****  ****  ****  **** **

   ...

   TASK [Remove remote archives]  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  *** 
   changed: [kinship]
   changed: [khaki]
   changed: [uncivil]
   changed: [urchin]

   PLAY RECAP  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  ****  **** **
   khaki                      : ok=3    changed=3    unreachable=0    failed=0
   kinship                    : ok=3    changed=3    unreachable=0    failed=0
   localhost                  : ok=3    changed=1    unreachable=0    failed=0
   uncivil                    : ok=3    changed=3    unreachable=0    failed=0
   urchin                     : ok=3    changed=3    unreachable=0    failed=0

より詳細な出力が必要な場合は、コマンドに\ ``-v`` 、\ ``-vv``
などを追加できます。

生成されたファイル
------------------

クラスターディレクトリの下で、各インスタンスのログを見つけることができます。

.. code:: bash

   ~/clusters/speedy/logs/
   `-- 220220306T185049
       |-- khaki-logs-20220306T185049.tar.gz
       |-- kinship-logs-20220306T185049.tar.gz
       |-- uncivil-logs-20220306T185049.tar.gz
       `-- urchin-logs-20220306T185049.tar.gz

アーカイブコンテンツの例

.. code:: bash

   khaki-logs
   |-- anaconda
   |   |-- anaconda.log
   |   |-- dbus.log
   |   |-- dnf.librepo.log
   |   |-- hawkey.log
   |   |-- journal.log
   |   |-- ks-script-ipdkisn0.log
   |   |-- ks-script-jr03uzns.log
   |   |-- ks-script-mh2iidvh.log
   |   |-- lvm.log
   |   |-- packaging.log
   |   |-- program.log
   |   |-- storage.log
   |   |-- syslog
   |   `-- X.log
   |-- btmp
   |-- dnf.librepo.log
   |-- dnf.log
   |-- dnf.rpm.log
   |-- hawkey.log
   |-- lastlog
   |-- private
   |-- tpaexec.log
   `-- wtmp