show-events
===========

Shows events such as background worker errors and node membership
changes.

Synopsis
^^^^^^^^

Shows events such as background worker errors and node membership
changes. Output is sorted by Time column in descending order. Message
column is truncated after a few lines. To view complete message use json
output format (‘-o json’).

For more details on each node state, see show-nodes command help (‘pgd
show-nodes -h’).

.. code:: sh

   pgd show-events [flags]

Examples
^^^^^^^^

.. code:: text


     Example 1 (3 node cluster)

     $ pgd show-events --lines 10

     Time                          Observer Node Subject Node Source    Type   Subtype      Message
     ----                          ------------- ------------ ------    ----   -------      -------
     2023-03-23 05:38:25.243257+00 witness-a1    witness-a1   consensus RAFT   STATE_CHANGE RAFT_LEADER
     2023-03-23 05:38:25.23815+00  witness-a1    witness-a1   consensus RAFT   STATE_CHANGE RAFT_CANDIDATE
     2023-03-23 05:38:21.197974+00 bdr-a1        bdr-a1       consensus RAFT   STATE_CHANGE RAFT_FOLLOWER
     2023-03-23 05:38:21.197107+00 witness-a1    witness-a1   consensus RAFT   STATE_CHANGE RAFT_FOLLOWER
     2023-03-23 05:38:21.169781+00 bdr-a2        bdr-a2       consensus RAFT   STATE_CHANGE RAFT_FOLLOWER
     2023-03-23 05:38:17.949669+00 witness-a1    bdr-a1       consensus NODE   STATE_CHANGE ACTIVE
     2023-03-23 05:38:17.949544+00 bdr-a1        bdr-a1       consensus NODE   STATE_CHANGE ACTIVE
     2023-03-23 05:38:17.946857+00 bdr-a2        bdr-a1       consensus NODE   STATE_CHANGE ACTIVE
     2023-03-23 05:38:17.91628+00  bdr-a1        bdr-a2       receiver  WORKER ERROR        pglogical worker received fast finish request, exiting
     2023-03-23 05:38:17.915236+00 witness-a1    bdr-a1       consensus NODE   STATE_CHANGE PROMOTING

Options
^^^^^^^

.. code:: text

     -h, --help        help for show-events
     -n, --lines int   show top n lines

Options inherited from parent commands
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code:: text

     -f, --config-file string   config file; ignored if
                                --dsn flag is present (default "/etc/edb/pgd-cli/pgd-cli-config.yml")
         --dsn string           database connection string
                                e.g."host=bdr-a1 port=5432 dbname=bdrdb user=postgres "
     -L, --log-level string     logging level: debug, info, warn, error (default "error")
     -o, --output string        output format: json, yaml
