rpl_reporting.h

Go to the documentation of this file.

/* Copyright (c) 2006, 2026, Oracle and/or its affiliates.
 
   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License, version 2.0,
   as published by the Free Software Foundation.
 
   This program is designed to work with certain software (including
   but not limited to OpenSSL) that is licensed under separate terms,
   as designated in a particular file or component or in included license
   documentation.  The authors of MySQL hereby grant you an additional
   permission to link the program and your derivative works with the
   separately licensed software that they have either included with
   the program or referenced in the documentation.
 
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License, version 2.0, for more details.
 
   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301  USA */
 
#ifndef RPL_REPORTING_H
#define RPL_REPORTING_H
 
#include <stdarg.h>
#include <stdio.h>
#include <sys/types.h>
#include <time.h>
#include <cstring>
 
#include "my_compiler.h"
#include "my_inttypes.h"
#include "my_systime.h"  //my_getsystime
#include "mysql/components/services/bits/mysql_mutex_bits.h"
#include "mysql/my_loglevel.h"
#include "mysql/psi/mysql_mutex.h"
 
/**
   Maximum size of an error message from a slave thread.
 */
#define MAX_SLAVE_ERRMSG 1024
 
class THD;
struct Gtid_specification;
 
/**
   Mix-in to handle the message logging and reporting for relay log
   info and master log info structures.
 
   By inheriting from this class, the class is imbued with
   capabilities to do slave reporting.
 */
class Slave_reporting_capability {
 public:
  /** lock used to synchronize m_last_error on 'SHOW REPLICA STATUS' **/
  mutable mysql_mutex_t err_lock;
  /**
     Constructor.
 
     @param thread_name Printable name of the slave thread that is reporting.
   */
  Slave_reporting_capability(char const *thread_name);
 
  /**
     Writes a message and, if it's an error message, to Last_Error
     (which will be displayed by SHOW REPLICA STATUS).
 
     @param level       The severity level
     @param err_code    The error code
     @param msg         The message (usually related to the error
                        code, but can contain more information), in
                        printf() format.
  */
  virtual void report(loglevel level, int err_code, const char *msg, ...) const
      MY_ATTRIBUTE((format(printf, 4, 5)));
 
  virtual void report(loglevel level, int err_code,
                      const Gtid_specification *gtid_next, const char *msg,
                      ...) const MY_ATTRIBUTE((format(printf, 5, 6)));
 
  void va_report(loglevel level, int err_code, const char *prefix_msg,
                 const char *msg, va_list v_args) const
      MY_ATTRIBUTE((format(printf, 5, 0)));
 
  /**
     Clear errors. They will not show up under <code>SHOW REPLICA
     STATUS</code>.
   */
  void clear_error() {
    mysql_mutex_lock(&err_lock);
    m_last_error.clear();
    mysql_mutex_unlock(&err_lock);
  }
 
  /**
     Check if the current error is of temporary nature or not.
  */
  int has_temporary_error(THD *thd, uint error_arg = 0,
                          bool *silent = nullptr) const;
 
  /**
     Error information structure.
   */
  class Error {
    friend class Slave_reporting_capability;
 
   public:
    Error() { clear(); }
 
    void clear() {
      number = 0;
      message[0] = '\0';
      timestamp[0] = '\0';
    }
 
    void update_timestamp() {
      struct tm tm_tmp;
      struct tm *start;
      time_t tt_tmp;
 
      skr = my_getsystime() / 10;
      tt_tmp = skr / 1000000;
      localtime_r(&tt_tmp, &tm_tmp);
      start = &tm_tmp;
 
      snprintf(timestamp, sizeof(timestamp), "%02d%02d%02d %02d:%02d:%02d",
               start->tm_year % 100, start->tm_mon + 1, start->tm_mday,
               start->tm_hour, start->tm_min, start->tm_sec);
      timestamp[15] = '\0';
    }
 
    void copy_from(const Error &other) {
      number = other.number;
      memcpy(message, other.message, MAX_SLAVE_ERRMSG);
      memcpy(timestamp, other.timestamp, 64);
      skr = other.skr;
    }
 
    /** Error code */
    uint32 number;
    /** Error message */
    char message[MAX_SLAVE_ERRMSG];
    /** Error timestamp as string */
    char timestamp[64];
    /** Error timestamp in microseconds. Used in performance_schema */
    ulonglong skr;
  };
 
  Error const &last_error() const { return m_last_error; }
  void copy_error_from(const Error &error, char message[MAX_SLAVE_ERRMSG]) {
    m_last_error.copy_from(error);
    memcpy(m_last_error.message, message, MAX_SLAVE_ERRMSG);
  }
  bool is_error() const { return last_error().number != 0; }
 
  /*
    For MSR, there is a need to introduce error messages per channel.
    Instead of changing the error messages in share/messages_to_error_log.txt
    to introduce the clause, FOR CHANNEL "%s", we construct a string like this.
    There might be problem with a client applications which could print
    error messages and see no %s.
    @TODO: fix this.
  */
  virtual const char *get_for_channel_str(bool upper_case) const = 0;
 
  virtual ~Slave_reporting_capability() = 0;
 
 protected:
  /// Allows subclasses to adjust the report level while holding err_lock,
  /// immediately before Last_Error is updated.
  /// Implementations must not acquire err_lock.
  /// @param level Report level requested by the caller.
  /// @param err_code Error code requested by the caller.
  /// @return Effective report level.
  virtual loglevel get_effective_report_level(loglevel level,
                                              int err_code) const;
 
  virtual void do_report(loglevel level, int err_code, const char *msg,
                         va_list v_args) const
      MY_ATTRIBUTE((format(printf, 4, 0)));
 
  virtual void do_report(loglevel level, int err_code,
                         const Gtid_specification *gtid_next, const char *msg,
                         va_list v_args) const
      MY_ATTRIBUTE((format(printf, 5, 0)));
 
  /**
     Last error produced by the I/O or SQL thread respectively.
   */
  mutable Error m_last_error;
 
 private:
  char const *const m_thread_name;
 
  // not implemented
  Slave_reporting_capability(const Slave_reporting_capability &rhs);
  Slave_reporting_capability &operator=(const Slave_reporting_capability &rhs);
};
 
inline void Slave_reporting_capability::do_report(loglevel level, int err_code,
                                                  const char *msg,
                                                  va_list v_args) const {
  va_report(level, err_code, nullptr, msg, v_args);
}
 
inline void Slave_reporting_capability::do_report(loglevel level, int err_code,
                                                  const Gtid_specification *,
                                                  const char *msg,
                                                  va_list v_args) const {
  va_report(level, err_code, nullptr, msg, v_args);
}
 
inline loglevel Slave_reporting_capability::get_effective_report_level(
    loglevel level, int) const {
  return level;
}
 
#endif  // RPL_REPORTING_H