aboutsummaryrefslogtreecommitdiffstats
path: root/node-admin/src/main/java/com/yahoo/vespa/hosted/node/admin/nodeadmin/ConvergenceException.java
blob: 686c32fd5ee2933a0e7a4b25c2f89a7517840766 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
// Copyright Vespa.ai. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.
package com.yahoo.vespa.hosted.node.admin.nodeadmin;

/**
 * Exception specially handled to avoid dumping full stack trace on convergence failure.
 *
 * @author hakonhall
 */
@SuppressWarnings("serial")
public class ConvergenceException extends RuntimeException {
    /** Create an exception that will NOT increment the monitored unhandled_exceptions metric. */
    public static ConvergenceException ofTransient(String message) { return ofTransient(message, null); }

    /** Create an exception that will NOT increment the monitored unhandled_exceptions metric. */
    public static ConvergenceException ofTransient(String message, Throwable t) { return new ConvergenceException(message, t, false); }

    /** Create an exception that increments the monitored unhandled_exceptions metric. */
    public static ConvergenceException ofError(String message) { return ofError(message, null); }

    /** Create an exception that increments the monitored unhandled_exceptions metric. */
    public static ConvergenceException ofError(String message, Throwable t) { return new ConvergenceException(message, t, true); }

    /** Create an exception with the same transient/error as the cause. */
    public static ConvergenceException ofNested(String message, ConvergenceException cause) { return new ConvergenceException(message, cause, cause.isError); }

    private final boolean isError;

    /** @param isError whether the exception should increment the monitored unhandled_exception metric. */
    protected ConvergenceException(String message, boolean isError) {
        this(message, null, isError);
    }

    /** @param isError whether the exception should increment the monitored unhandled_exception metric. */
    protected ConvergenceException(String message, Throwable t, boolean isError) {
        super(message, t);
        this.isError = isError;
    }

    /** Whether the exception signals an error someone may want to look at, or whether it is expected to be transient (false). */
    public boolean isError() { return isError; }
}