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

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

.. code:: bash

   tpaexec archive-logs <cluster-dir>

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

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

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

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

.. 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