src/plugins/perfmon/perfmon.h

   1 /*
   2  * perfmon.h - performance monitor
   3  *
   4  * Copyright (c) 2018 Cisco Systems and/or its affiliates
   5  * Licensed under the Apache License, Version 2.0 (the "License");
   6  * you may not use this file except in compliance with the License.
   7  * You may obtain a copy of the License at:
   8  *
   9  *     http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  * Unless required by applicable law or agreed to in writing, software
  12  * distributed under the License is distributed on an "AS IS" BASIS,
  13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  * See the License for the specific language governing permissions and
  15  * limitations under the License.
  16  */
  17 #ifndef __included_perfmon_h__
  18 #define __included_perfmon_h__
  19
  20 #include <vnet/vnet.h>
  21 #include <vnet/ip/ip.h>
  22 #include <vnet/ethernet/ethernet.h>
  23 #include <vlib/log.h>
  24
  25 #include <vppinfra/hash.h>
  26 #include <vppinfra/error.h>
  27
  28 #include <linux/perf_event.h>
  29
  30 #define foreach_perfmon_event                                           \
  31 _(PERF_TYPE_HARDWARE, PERF_COUNT_HW_CPU_CYCLES, "cpu-cycles")           \
  32 _(PERF_TYPE_HARDWARE, PERF_COUNT_HW_INSTRUCTIONS, "instructions")       \
  33 _(PERF_TYPE_HARDWARE, PERF_COUNT_HW_CACHE_REFERENCES,                   \
  34   "cache-references")                                                   \
  35 _(PERF_TYPE_HARDWARE, PERF_COUNT_HW_CACHE_MISSES, "cache-misses")       \
  36 _(PERF_TYPE_HARDWARE, PERF_COUNT_HW_BRANCH_INSTRUCTIONS, "branches")    \
  37  _(PERF_TYPE_HARDWARE, PERF_COUNT_HW_BRANCH_MISSES, "branch-misses")    \
  38 _(PERF_TYPE_HARDWARE, PERF_COUNT_HW_BUS_CYCLES, "bus-cycles")           \
  39 _(PERF_TYPE_HARDWARE, PERF_COUNT_HW_STALLED_CYCLES_FRONTEND,            \
  40   "stall-frontend")                                                     \
  41 _(PERF_TYPE_HARDWARE, PERF_COUNT_HW_STALLED_CYCLES_BACKEND,             \
  42   "stall-backend")                                                      \
  43 _(PERF_TYPE_HARDWARE, PERF_COUNT_HW_REF_CPU_CYCLES, "ref-cpu-cycles")   \
  44 _(PERF_TYPE_SOFTWARE, PERF_COUNT_SW_PAGE_FAULTS, "page-faults")         \
  45 _(PERF_TYPE_SOFTWARE, PERF_COUNT_SW_CONTEXT_SWITCHES, "context-switches") \
  46 _(PERF_TYPE_SOFTWARE, PERF_COUNT_SW_CPU_MIGRATIONS, "cpu-migrations")   \
  47 _(PERF_TYPE_SOFTWARE, PERF_COUNT_SW_PAGE_FAULTS_MIN, "minor-pagefaults") \
  48 _(PERF_TYPE_SOFTWARE, PERF_COUNT_SW_PAGE_FAULTS_MAJ, "major-pagefaults") \
  49 _(PERF_TYPE_SOFTWARE, PERF_COUNT_SW_EMULATION_FAULTS, "emulation-faults")
  50
  51 typedef struct
  52 {
  53   char *name;
  54   int pe_type;
  55   int pe_config;
  56 } perfmon_event_config_t;
  57
  58 typedef enum
  59 {
  60   PERFMON_STATE_OFF = 0,
  61   PERFMON_STATE_RUNNING,
  62 } perfmon_state_t;
  63
  64 typedef struct
  65 {
  66   u8 *thread_and_node_name;
  67   u8 **counter_names;
  68   u64 *counter_values;
  69   u64 *vectors_this_counter;
  70 } perfmon_capture_t;
  71
  72 typedef struct
  73 {
  74   u32 cpuid;
  75   const char **table;
  76 } perfmon_cpuid_and_table_t;
  77
  78 typedef struct
  79 {
  80   u8 *name;
  81   u8 *value;
  82 } name_value_pair_t;
  83
  84 typedef struct
  85 {
  86   /* API message ID base */
  87   u16 msg_id_base;
  88
  89   /* on/off switch for the periodic function */
  90   volatile u8 state;
  91
  92   /* capture pool, hash table */
  93   perfmon_capture_t *capture_pool;
  94   uword *capture_by_thread_and_node_name;
  95
  96   /* CPU-specific event tables, hash table of selected table (if any)  */
  97   perfmon_cpuid_and_table_t *perfmon_tables;
  98   uword *perfmon_table;
  99
 100   /* vector of single events to collect */
 101   perfmon_event_config_t *single_events_to_collect;
 102
 103   /* vector of paired events to collect */
 104   perfmon_event_config_t *paired_events_to_collect;
 105
 106   /* Base indices of synthetic event tuples */
 107   u32 ipc_event_index;
 108   u32 mispredict_event_index;
 109
 110   /* Length of time to capture a single event */
 111   f64 timeout_interval;
 112
 113   /* Current event (index) being collected */
 114   u32 current_event;
 115   int n_active;
 116   u32 **rdpmc_indices;
 117   /* mmap base / size of (mapped) struct perf_event_mmap_page */
 118   u8 ***perf_event_pages;
 119   u32 page_size;
 120
 121   /* Current perf_event file descriptors, per thread */
 122   int **pm_fds;
 123
 124   /* thread bitmap */
 125   uword *thread_bitmap;
 126
 127   /* Logging */
 128   vlib_log_class_t log_class;
 129
 130   /* convenience */
 131   vlib_main_t *vlib_main;
 132   vnet_main_t *vnet_main;
 133   ethernet_main_t *ethernet_main;
 134 } perfmon_main_t;
 135
 136 extern perfmon_main_t perfmon_main;
 137
 138 extern vlib_node_registration_t perfmon_periodic_node;
 139 uword *perfmon_parse_table (perfmon_main_t * pm, char *path, char *filename);
 140
 141 /* Periodic function events */
 142 #define PERFMON_START 1
 143
 144 #endif /* __included_perfmon_h__ */
 145
 146 /*
 147  * fd.io coding-style-patch-verification: ON
 148  *
 149  * Local Variables:
 150  * eval: (c-set-style "gnu")
 151  * End:
 152  */