com.kdgregory.logging.aws.sns.SNSWriterStatisticsMXBean Maven / Gradle / Ivy
// Copyright (c) Keith D Gregory
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package com.kdgregory.logging.aws.sns;
import java.util.Date;
import java.util.List;
import javax.management.MXBean;
/**
* Defines the JMX Bean interface for {@link SNSWriterStatistics}.
*/
@MXBean
public interface SNSWriterStatisticsMXBean
{
/**
* Returns the actual topic name used by the writer (after substitutions).
*/
String getActualTopicName();
/**
* Returns the actual topic ARN used by the writer (after substitutions).
*/
String getActualTopicArn();
/**
* Returns the actual subject used by the writer (after substitutions).
*/
String getActualSubject();
/**
* Returns the most recent error from the writer. This will be null if there
* have been no errors.
*/
String getLastErrorMessage();
/**
* Returns the timestamp of the most recent error from the writer. This will be
* null if there have been no errors.
*/
Date getLastErrorTimestamp();
/**
* Returns the stack trace of the most recent error from the writer. This will be
* null if there have been no errors or if the error did not have an associated
* exception.
*/
List getLastErrorStacktrace();
/**
* Returns the number of messages successfully sent to the topic.
*/
int getMessagesSent();
/**
* Returns the number of messages successfully sent to the logstream in the last
* batch. This should be at least 1; higher values indicate how many messages
* will be lost if the program shuts down unexpectedly.
*/
int getMessagesSentLastBatch();
/**
* Returns the number of messages requeued because they could not be sent. This
* should be 0; non-zero values indicate throttling or an error condition (see
* {@link #getLastErrorMessage} and {@link #getWriterRaceRetries} for more info).
*/
int getMessagesRequeuedLastBatch();
/**
* Returns the number of messages discarded by the writer's message queue.
*/
int getMessagesDiscarded();
}