This number (defaults to 1) sets how many times mon_connect_to_db will try to connect to a backend before returning an error. Every connection attempt may take backend_connect_timeout seconds to complete. Also refactored code a bit. Renamed mon_connect_to_db to mon_ping_or_connect_to_db, since it does not connect if the connection is already alive.
		
			
				
	
	
		
			102 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			102 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
#pragma once
 | 
						|
/*
 | 
						|
 * Copyright (c) 2016 MariaDB Corporation Ab
 | 
						|
 *
 | 
						|
 * Use of this software is governed by the Business Source License included
 | 
						|
 * in the LICENSE.TXT file and at www.mariadb.com/bsl11.
 | 
						|
 *
 | 
						|
 * Change Date: 2019-07-01
 | 
						|
 *
 | 
						|
 * On the date above, in accordance with the Business Source License, use
 | 
						|
 * of this software will be governed by version 2 or later of the General
 | 
						|
 * Public License.
 | 
						|
 */
 | 
						|
 | 
						|
/**
 | 
						|
 * @file core/maxscale/monitor.h - The private monitor interface
 | 
						|
 */
 | 
						|
 | 
						|
#include <maxscale/monitor.h>
 | 
						|
 | 
						|
MXS_BEGIN_DECLS
 | 
						|
 | 
						|
#define MON_ARG_MAX 8192
 | 
						|
 | 
						|
#define DEFAULT_CONNECT_TIMEOUT 3
 | 
						|
#define DEFAULT_READ_TIMEOUT 1
 | 
						|
#define DEFAULT_WRITE_TIMEOUT 2
 | 
						|
#define DEFAULT_CONNECTION_ATTEMPTS 1
 | 
						|
 | 
						|
#define MONITOR_DEFAULT_INTERVAL 10000 // in milliseconds
 | 
						|
 | 
						|
/**
 | 
						|
 * Monitor network timeout types
 | 
						|
 */
 | 
						|
typedef enum
 | 
						|
{
 | 
						|
    MONITOR_CONNECT_TIMEOUT = 0,
 | 
						|
    MONITOR_READ_TIMEOUT    = 1,
 | 
						|
    MONITOR_WRITE_TIMEOUT   = 2,
 | 
						|
    MONITOR_CONNECT_ATTEMPTS = 3
 | 
						|
} monitor_timeouts_t;
 | 
						|
 | 
						|
MXS_MONITOR *monitor_alloc(char *, char *);
 | 
						|
void monitor_free(MXS_MONITOR *);
 | 
						|
 | 
						|
void monitorStart(MXS_MONITOR *, const MXS_CONFIG_PARAMETER*);
 | 
						|
void monitorStop(MXS_MONITOR *);
 | 
						|
void monitorStopAll();
 | 
						|
void monitorStartAll();
 | 
						|
 | 
						|
MXS_MONITOR *monitor_find(const char *);
 | 
						|
 | 
						|
void monitorShow(DCB *, MXS_MONITOR *);
 | 
						|
void monitorShowAll(DCB *);
 | 
						|
 | 
						|
void monitorList(DCB *);
 | 
						|
RESULTSET *monitorGetList();
 | 
						|
 | 
						|
bool monitorAddServer(MXS_MONITOR *mon, SERVER *server);
 | 
						|
void monitorRemoveServer(MXS_MONITOR *mon, SERVER *server);
 | 
						|
void monitorAddUser(MXS_MONITOR *, char *, char *);
 | 
						|
void monitorAddParameters(MXS_MONITOR *monitor, MXS_CONFIG_PARAMETER *params);
 | 
						|
bool monitorRemoveParameter(MXS_MONITOR *monitor, const char *key);
 | 
						|
 | 
						|
void monitorSetInterval (MXS_MONITOR *, unsigned long);
 | 
						|
bool monitorSetNetworkTimeout(MXS_MONITOR *, int, int);
 | 
						|
 | 
						|
/**
 | 
						|
 * @brief Serialize the servers of a monitor to a file
 | 
						|
 *
 | 
						|
 * This partially converts @c monitor into an INI format file. Only the servers
 | 
						|
 * of the monitor are serialized. This allows the monitor to keep monitoring
 | 
						|
 * the servers that were added at runtime even after a restart.
 | 
						|
 *
 | 
						|
 * NOTE: This does not persist the complete monitor configuration and requires
 | 
						|
 * that an existing monitor configuration is in the main configuration file.
 | 
						|
 * Changes to monitor parameters are not persisted.
 | 
						|
 *
 | 
						|
 * @param monitor Monitor to serialize
 | 
						|
 * @return False if the serialization of the monitor fails, true if it was successful
 | 
						|
 */
 | 
						|
bool monitor_serialize_servers(const MXS_MONITOR *monitor);
 | 
						|
 | 
						|
/**
 | 
						|
 * @brief Serialize a monitor to a file
 | 
						|
 *
 | 
						|
 * This converts the static configuration of the monitor into an INI format file.
 | 
						|
 *
 | 
						|
 * @param monitor Monitor to serialize
 | 
						|
 * @return True if serialization was successful
 | 
						|
 */
 | 
						|
bool monitor_serialize(const MXS_MONITOR *monitor);
 | 
						|
 | 
						|
/**
 | 
						|
 * Check if a server is being monitored and return the monitor.
 | 
						|
 * @param server Server that is queried
 | 
						|
 * @return The monitor watching this server, or NULL if not monitored
 | 
						|
 */
 | 
						|
MXS_MONITOR* monitor_server_in_use(const SERVER *server);
 | 
						|
 | 
						|
MXS_END_DECLS
 |