[v7,0/2] guide to debug and troubleshoot.

  The patch series adds a how-to guide for debugging and
troubleshooting tips.

Motivation
==========

DPDK proc-info tool is been enhanced to accommodate the debug information
for the port, traffic manager crypto, ring and mempool contents. With these
additional information, it becomes easy to analyze issues and performance
variance.

But applications are designed based on the target platform, workload, poll
mode drivers, and multi-process. This raises variance in debugging and
collecting data. Hence attempt of patch series is identified such symptoms
and share step by step guide to cover the cases.

Not all possible cases could be covered in a single attempt. But with
feedback and support from the community, this can be expanded.

Status
======

Reviews and changes accommodated. ACK received for documentation and SVG
files.

Change Log:
==========

V7:
 - add space to note and indent - John Macnamara

V6:
 - correction for word style and grammar - Thomas Monjalon
 - add license for svg files - Vipin Varghese

v5:
 - rework of content - Vipin Varghese

V4:
 - Correction for word style - Shreyansh Jain

V3:
 - reorder for removing warning in 'make doc-guides-html' - Thomas Monjalon

V2:
 - add offload flag check - Vipin Varghese
 - change tab to space - Marko Kovacevic
 - spelling correction - Marko Kovacevic
 - remove extra characters - Marko Kovacevic
 - add ACK by Marko - Vipn Varghese
 - add ACK from Marko - Vipin Varghese


Vipin Varghese (2):
  doc: add svg for debug and troubleshoot guide
  doc: add guide for debug and troubleshoot

 doc/guides/howto/debug_troubleshoot_guide.rst | 465 ++++++++++++++++++
 doc/guides/howto/img/dtg_consumer_ring.svg    |  24 +
 doc/guides/howto/img/dtg_crypto.svg           |  21 +
 .../howto/img/dtg_distributor_worker.svg      |  36 ++
 doc/guides/howto/img/dtg_mempool.svg          |  27 +
 doc/guides/howto/img/dtg_pdump.svg            |  33 ++
 doc/guides/howto/img/dtg_producer_ring.svg    |  24 +
 doc/guides/howto/img/dtg_qos_tx.svg           |  29 ++
 doc/guides/howto/img/dtg_rx_rate.svg          |  25 +
 doc/guides/howto/img/dtg_rx_tx_drop.svg       |  33 ++
 doc/guides/howto/img/dtg_sample_app_model.svg | 110 +++++
 doc/guides/howto/img/dtg_service.svg          |  20 +
 doc/guides/howto/index.rst                    |   1 +
 13 files changed, 848 insertions(+)
 create mode 100644 doc/guides/howto/debug_troubleshoot_guide.rst
 create mode 100644 doc/guides/howto/img/dtg_consumer_ring.svg
 create mode 100644 doc/guides/howto/img/dtg_crypto.svg
 create mode 100644 doc/guides/howto/img/dtg_distributor_worker.svg
 create mode 100644 doc/guides/howto/img/dtg_mempool.svg
 create mode 100644 doc/guides/howto/img/dtg_pdump.svg
 create mode 100644 doc/guides/howto/img/dtg_producer_ring.svg
 create mode 100644 doc/guides/howto/img/dtg_qos_tx.svg
 create mode 100644 doc/guides/howto/img/dtg_rx_rate.svg
 create mode 100644 doc/guides/howto/img/dtg_rx_tx_drop.svg
 create mode 100644 doc/guides/howto/img/dtg_sample_app_model.svg
 create mode 100644 doc/guides/howto/img/dtg_service.svg
  

Hi John and Marko,

Waiting for updates for changes if any, as these are not pushed for 19.02. 

Please do let me know if there are changes required any more?

Thanks
Vipin Varghese

> -----Original Message-----
> From: Varghese, Vipin
> Sent: Monday, February 25, 2019 10:42 PM
> To: Mcnamara, John <john.mcnamara@intel.com>; Kovacevic, Marko
> <marko.kovacevic@intel.com>; thomas@monjalon.net; Yigit, Ferruh
> <ferruh.yigit@intel.com>; shreyansh.jain@nxp.com; dev@dpdk.org
> Cc: Padubidri, Sanjay A <sanjay.padubidri@intel.com>; Patel, Amol
> <amol.patel@intel.com>; Varghese, Vipin <vipin.varghese@intel.com>
> Subject: [PATCH v7 0/2] guide to debug and troubleshoot.
> 
> The patch series adds a how-to guide for debugging and troubleshooting tips.
> 
> Motivation
> ==========
> 
> DPDK proc-info tool is been enhanced to accommodate the debug information
> for the port, traffic manager crypto, ring and mempool contents. With these
> additional information, it becomes easy to analyze issues and performance
> variance.
> 
> But applications are designed based on the target platform, workload, poll mode
> drivers, and multi-process. This raises variance in debugging and collecting data.
> Hence attempt of patch series is identified such symptoms and share step by step
> guide to cover the cases.
> 
> Not all possible cases could be covered in a single attempt. But with feedback and
> support from the community, this can be expanded.
> 
> Status
> ======
> 
> Reviews and changes accommodated. ACK received for documentation and SVG
> files.
> 
> Change Log:
> ==========
> 
> V7:
>  - add space to note and indent - John Macnamara
> 
> V6:
>  - correction for word style and grammar - Thomas Monjalon
>  - add license for svg files - Vipin Varghese
> 
> v5:
>  - rework of content - Vipin Varghese
> 
> V4:
>  - Correction for word style - Shreyansh Jain
> 
> V3:
>  - reorder for removing warning in 'make doc-guides-html' - Thomas Monjalon
> 
> V2:
>  - add offload flag check - Vipin Varghese
>  - change tab to space - Marko Kovacevic
>  - spelling correction - Marko Kovacevic
>  - remove extra characters - Marko Kovacevic
>  - add ACK by Marko - Vipn Varghese
>  - add ACK from Marko - Vipin Varghese
> 
> 
> Vipin Varghese (2):
>   doc: add svg for debug and troubleshoot guide
>   doc: add guide for debug and troubleshoot
> 
>  doc/guides/howto/debug_troubleshoot_guide.rst | 465 ++++++++++++++++++
>  doc/guides/howto/img/dtg_consumer_ring.svg    |  24 +
>  doc/guides/howto/img/dtg_crypto.svg           |  21 +
>  .../howto/img/dtg_distributor_worker.svg      |  36 ++
>  doc/guides/howto/img/dtg_mempool.svg          |  27 +
>  doc/guides/howto/img/dtg_pdump.svg            |  33 ++
>  doc/guides/howto/img/dtg_producer_ring.svg    |  24 +
>  doc/guides/howto/img/dtg_qos_tx.svg           |  29 ++
>  doc/guides/howto/img/dtg_rx_rate.svg          |  25 +
>  doc/guides/howto/img/dtg_rx_tx_drop.svg       |  33 ++
>  doc/guides/howto/img/dtg_sample_app_model.svg | 110 +++++
>  doc/guides/howto/img/dtg_service.svg          |  20 +
>  doc/guides/howto/index.rst                    |   1 +
>  13 files changed, 848 insertions(+)
>  create mode 100644 doc/guides/howto/debug_troubleshoot_guide.rst
>  create mode 100644 doc/guides/howto/img/dtg_consumer_ring.svg
>  create mode 100644 doc/guides/howto/img/dtg_crypto.svg
>  create mode 100644 doc/guides/howto/img/dtg_distributor_worker.svg
>  create mode 100644 doc/guides/howto/img/dtg_mempool.svg
>  create mode 100644 doc/guides/howto/img/dtg_pdump.svg
>  create mode 100644 doc/guides/howto/img/dtg_producer_ring.svg
>  create mode 100644 doc/guides/howto/img/dtg_qos_tx.svg
>  create mode 100644 doc/guides/howto/img/dtg_rx_rate.svg
>  create mode 100644 doc/guides/howto/img/dtg_rx_tx_drop.svg
>  create mode 100644 doc/guides/howto/img/dtg_sample_app_model.svg
>  create mode 100644 doc/guides/howto/img/dtg_service.svg
> 
> --
> 2.17.1