2 * SPDX-License-Identifier: LGPL-2.1-only
4 * Copyright (C) 2015 EfficiOS Inc.
5 * Copyright (C) 2015 Alexandre Montplaisir <alexmonthy@efficios.com>
8 package org
.lttng
.ust
.agent
;
10 import java
.util
.Collection
;
14 * Interface to define LTTng Java agents.
16 * An "agent" is a representative of an LTTng session daemon in the Java world.
17 * It tracks the settings of a tracing session as they defined in the session
20 * It also track the current logging handlers that are sending events to UST.
22 * @author Alexandre Montplaisir
25 * The type of logging handler that should register to this agent
27 public interface ILttngAgent
<T
extends ILttngHandler
> {
29 // ------------------------------------------------------------------------
30 // Agent configuration elements
31 // ------------------------------------------------------------------------
34 * Tracing domains. Corresponds to domains defined by LTTng Tools.
40 private Domain(int value
) {
50 * The tracing domain of this agent.
52 * @return The tracing domain.
56 // ------------------------------------------------------------------------
57 // Log handler registering
58 // ------------------------------------------------------------------------
61 * Register a handler to this agent.
64 * The handler to register
66 void registerHandler(T handler
);
69 * Deregister a handler from this agent.
72 * The handler to deregister.
74 void unregisterHandler(T handler
);
76 // ------------------------------------------------------------------------
77 // Tracing session parameters
78 // ------------------------------------------------------------------------
81 * Query if a given event is currently enabled in a current tracing session,
82 * meaning it should be sent to UST.
85 * The name of the event to check.
86 * @return True if the event is currently enabled, false if it is not.
88 boolean isEventEnabled(String eventName
);
91 * Return the list of application contexts enabled in the tracing sessions.
93 * @return The application contexts, first indexed by retriever name, then
96 Collection
<Map
.Entry
<String
, Map
<String
, Integer
>>> getEnabledAppContexts();
This page took 0.032591 seconds and 5 git commands to generate.