538d9c1829
perf_events may sometimes throttle an event due to creating too many
samples during a given timer tick.
As of now, the perf tool will not report on throttling, which means this
is a silent error.
Implement a callback for the throttle and unthrottle events within the
Python scripting engine, which can allow scripts to detect and report
when events may have been lost due to throttling.
The simplest script to report throttle events is:
def throttle(*args):
print("throttle" + repr(args))
def unthrottle(*args):
print("unthrottle" + repr(args))
Signed-off-by: Stephen Brennan <stephen.s.brennan@oracle.com>
Cc: Alexander Shishkin <alexander.shishkin@linux.intel.com>
Cc: Jiri Olsa <jolsa@redhat.com>
Cc: Mark Rutland <mark.rutland@arm.com>
Cc: Namhyung Kim <namhyung@kernel.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Link: http://lore.kernel.org/lkml/20210901210815.133251-1-stephen.s.brennan@oracle.com
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
135 lines
4.1 KiB
C
135 lines
4.1 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
#ifndef _PERF_UTIL_TRACE_EVENT_H
|
|
#define _PERF_UTIL_TRACE_EVENT_H
|
|
|
|
#include <traceevent/event-parse.h>
|
|
#include "parse-events.h"
|
|
|
|
struct machine;
|
|
struct perf_sample;
|
|
union perf_event;
|
|
struct perf_tool;
|
|
struct thread;
|
|
struct tep_plugin_list;
|
|
struct evsel;
|
|
|
|
struct trace_event {
|
|
struct tep_handle *pevent;
|
|
struct tep_plugin_list *plugin_list;
|
|
};
|
|
|
|
int trace_event__init(struct trace_event *t);
|
|
void trace_event__cleanup(struct trace_event *t);
|
|
int trace_event__register_resolver(struct machine *machine,
|
|
tep_func_resolver_t *func);
|
|
struct tep_event*
|
|
trace_event__tp_format(const char *sys, const char *name);
|
|
|
|
struct tep_event *trace_event__tp_format_id(int id);
|
|
|
|
int bigendian(void);
|
|
|
|
void event_format__fprintf(struct tep_event *event,
|
|
int cpu, void *data, int size, FILE *fp);
|
|
|
|
void event_format__print(struct tep_event *event,
|
|
int cpu, void *data, int size);
|
|
|
|
int parse_ftrace_file(struct tep_handle *pevent, char *buf, unsigned long size);
|
|
int parse_event_file(struct tep_handle *pevent,
|
|
char *buf, unsigned long size, char *sys);
|
|
|
|
unsigned long long
|
|
raw_field_value(struct tep_event *event, const char *name, void *data);
|
|
|
|
void parse_proc_kallsyms(struct tep_handle *pevent, char *file, unsigned int size);
|
|
void parse_ftrace_printk(struct tep_handle *pevent, char *file, unsigned int size);
|
|
void parse_saved_cmdline(struct tep_handle *pevent, char *file, unsigned int size);
|
|
|
|
ssize_t trace_report(int fd, struct trace_event *tevent, bool repipe);
|
|
|
|
unsigned long long read_size(struct tep_event *event, void *ptr, int size);
|
|
unsigned long long eval_flag(const char *flag);
|
|
|
|
int read_tracing_data(int fd, struct list_head *pattrs);
|
|
|
|
struct tracing_data {
|
|
/* size is only valid if temp is 'true' */
|
|
ssize_t size;
|
|
bool temp;
|
|
char temp_file[50];
|
|
};
|
|
|
|
struct tracing_data *tracing_data_get(struct list_head *pattrs,
|
|
int fd, bool temp);
|
|
int tracing_data_put(struct tracing_data *tdata);
|
|
|
|
|
|
struct addr_location;
|
|
|
|
struct perf_session;
|
|
struct perf_stat_config;
|
|
|
|
struct scripting_ops {
|
|
const char *name;
|
|
const char *dirname; /* For script path .../scripts/<dirname>/... */
|
|
int (*start_script)(const char *script, int argc, const char **argv,
|
|
struct perf_session *session);
|
|
int (*flush_script) (void);
|
|
int (*stop_script) (void);
|
|
void (*process_event) (union perf_event *event,
|
|
struct perf_sample *sample,
|
|
struct evsel *evsel,
|
|
struct addr_location *al,
|
|
struct addr_location *addr_al);
|
|
void (*process_switch)(union perf_event *event,
|
|
struct perf_sample *sample,
|
|
struct machine *machine);
|
|
void (*process_auxtrace_error)(struct perf_session *session,
|
|
union perf_event *event);
|
|
void (*process_stat)(struct perf_stat_config *config,
|
|
struct evsel *evsel, u64 tstamp);
|
|
void (*process_stat_interval)(u64 tstamp);
|
|
void (*process_throttle)(union perf_event *event,
|
|
struct perf_sample *sample,
|
|
struct machine *machine);
|
|
int (*generate_script) (struct tep_handle *pevent, const char *outfile);
|
|
};
|
|
|
|
extern unsigned int scripting_max_stack;
|
|
|
|
int script_spec_register(const char *spec, struct scripting_ops *ops);
|
|
|
|
void script_fetch_insn(struct perf_sample *sample, struct thread *thread,
|
|
struct machine *machine);
|
|
|
|
void setup_perl_scripting(void);
|
|
void setup_python_scripting(void);
|
|
|
|
struct scripting_context {
|
|
struct tep_handle *pevent;
|
|
void *event_data;
|
|
union perf_event *event;
|
|
struct perf_sample *sample;
|
|
struct evsel *evsel;
|
|
struct addr_location *al;
|
|
struct addr_location *addr_al;
|
|
struct perf_session *session;
|
|
};
|
|
|
|
void scripting_context__update(struct scripting_context *scripting_context,
|
|
union perf_event *event,
|
|
struct perf_sample *sample,
|
|
struct evsel *evsel,
|
|
struct addr_location *al,
|
|
struct addr_location *addr_al);
|
|
|
|
int common_pc(struct scripting_context *context);
|
|
int common_flags(struct scripting_context *context);
|
|
int common_lock_depth(struct scripting_context *context);
|
|
|
|
#define SAMPLE_FLAGS_BUF_SIZE 64
|
|
int perf_sample__sprintf_flags(u32 flags, char *str, size_t sz);
|
|
|
|
#endif /* _PERF_UTIL_TRACE_EVENT_H */
|