Field Detail

• RATES

  static final long[] RATES

  Rate periods for history tracking

• TUNNEL_REJECT_BANDWIDTH

  public static final int TUNNEL_REJECT_BANDWIDTH

  Tunnel rejection due to excess bandwidth usage - used for most rejections even if not really for bandwidth

  See Also:

  Constant Field Values

• TUNNEL_REJECT_CRIT

  public static final int TUNNEL_REJECT_CRIT

  Tunnel rejection due to system failure - not currently used

  See Also:

  Constant Field Values

• TUNNEL_REJECT_PROBABALISTIC_REJECT

  public static final int TUNNEL_REJECT_PROBABALISTIC_REJECT

  Probabalistic tunnel rejection due to a flood of requests - infrequent

  See Also:

  Constant Field Values

• TUNNEL_REJECT_STREAMING_NACK

  public static final int TUNNEL_REJECT_STREAMING_NACK

  Streaming NACK - peer accepted tunnel but can't deliver data

  See Also:

  Constant Field Values

• TUNNEL_REJECT_TRANSIENT_OVERLOAD

  public static final int TUNNEL_REJECT_TRANSIENT_OVERLOAD

  Tunnel rejection due to temporary cpu/job/tunnel overload - rare

  See Also:

  Constant Field Values

Constructor Detail

• TunnelHistory

  public TunnelHistory(RouterContext context,
                       String statGroup)

  TunnelHistory.

Method Detail

• coalesceStats

  public void coalesceStats()

  Coalesce the rate statistics.

• getAcceptanceRatio

  public double getAcceptanceRatio()

  Calculate the ratio of accepted to rejected tunnel requests.

  Returns:

  ratio (0.0 to 1.0), or 1.0 if no data available

• getFailedRate

  public RateStat getFailedRate()

  Failure rate statistics for this peer.

  Returns:

  the failed rate

• getLastAgreedTo

  public long getLastAgreedTo()

  When the peer last agreed to participate in a tunnel

• getLastFailed

  public long getLastFailed()

  When the last tunnel the peer participated in failed

• getLastRejectedBandwidth

  public long getLastRejectedBandwidth()

  When the peer last refused to participate in a tunnel complaining of bandwidth overload

• getLastRejectedCritical

  public long getLastRejectedCritical()

  When the peer last refused to participate in a tunnel with level of critical

• getLastRejectedProbabalistic

  public long getLastRejectedProbabalistic()

  When the peer last refused to participate in a tunnel probabalistically

• getLastRejectedTransient

  public long getLastRejectedTransient()

  When the peer last refused to participate in a tunnel complaining of transient overload

• getLastTestedSuccessfully

  public long getLastTestedSuccessfully()

  When the peer last passed a tunnel test

• getLifetimeAgreedTo

  public long getLifetimeAgreedTo()

  Total tunnels the peer has agreed to participate in

• getLifetimeFailed

  public long getLifetimeFailed()

  Total tunnels the peer has agreed to participate in that were later marked as failed prematurely

• getLifetimeRejected

  public long getLifetimeRejected()

  Total tunnels the peer has refused to participate in

• getRejectionRate

  public RateStat getRejectionRate()

  Rejection rate statistics for this peer.

  Returns:

  the rejection rate

• incrementAgreedTo

  public void incrementAgreedTo()

  Count a tunnel participation agreement and record its time.

• incrementFailed

  public void incrementFailed(int pct)

  Define this rate as the probability it really failed

  Parameters:

  pct - = probability * 100

• incrementProcessed

  public void incrementProcessed(int processedSuccessfully,
                                 int failedProcessing)

  Processed message counter; legacy method, no longer tracked.

• incrementRejected

  public void incrementRejected(int severity)

  Count a tunnel rejection at the given severity and record its time.

  Parameters:

  severity - how much the peer doesnt want to participate in the tunnel (large == more severe)

• incrementTestSucceeded

  public void incrementTestSucceeded()

  Record that a tunnel test through this peer succeeded. This indicates the peer is actively participating in working tunnels.

• load

  public void load(Properties props)

  Restore the tunnel history fields from the given properties.

• store

  public void store(OutputStream out)
             throws IOException

  Write the tunnel history to the stream, including comments.

  Throws:

  IOException

• store

  public void store(OutputStream out,
                    boolean addComments)
             throws IOException

  Write the data from the profile to the stream

  Parameters:

  addComments - add comment lines to the output

  Throws:

  IOException