044bdf07c3adebb3f5085a1430d6f0d057fb0c05
2 * Copyright (C) 2015 - EfficiOS Inc., Alexandre Montplaisir <alexmonthy@efficios.com>
4 * This library is free software; you can redistribute it and/or modify it
5 * under the terms of the GNU Lesser General Public License, version 2.1 only,
6 * as published by the Free Software Foundation.
8 * This library is distributed in the hope that it will be useful, but WITHOUT
9 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
13 * You should have received a copy of the GNU Lesser General Public License
14 * along with this library; if not, write to the Free Software Foundation,
15 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18 package org
.lttng
.ust
.agent
;
21 * Interface to define LTTng Java agents.
23 * An "agent" is a representative of an LTTng session daemon in the Java world.
24 * It tracks the settings of a tracing session as they defined in the session
27 * It also track the current logging handlers that are sending events to UST.
29 * @author Alexandre Montplaisir
32 * The type of logging handler that should register to this agent
34 public interface ILttngAgent
<T
extends ILttngHandler
> {
36 // ------------------------------------------------------------------------
37 // Agent configuration elements
38 // ------------------------------------------------------------------------
41 * Tracing domains. Corresponds to domains defined by LTTng Tools.
47 private Domain(int value
) {
57 * The tracing domain of this agent.
59 * @return The tracing domain.
63 // ------------------------------------------------------------------------
64 // Log handler registering
65 // ------------------------------------------------------------------------
68 * Register a handler to this agent.
71 * The handler to register
73 void registerHandler(T handler
);
76 * Deregister a handler from this agent.
79 * The handler to deregister.
81 void unregisterHandler(T handler
);
83 // ------------------------------------------------------------------------
84 // Tracing session parameters
85 // ------------------------------------------------------------------------
88 * Query if a given event is currently enabled in a current tracing session,
89 * meaning it should be sent to UST. May be quicker than listing all events
90 * via {@link #listEnabledEvents()}.
93 * The name of the event to check.
94 * @return True if the event is currently enabled, false if it is not.
96 boolean isEventEnabled(String eventName
);
99 * List the all events currently enabled in the current tracing sessions.
101 * @return The list of enabled events
103 Iterable
<String
> listEnabledEvents();
This page took 0.03631 seconds and 4 git commands to generate.