mirror of
https://github.com/ossrs/srs.git
synced 2025-02-13 11:51:57 +00:00
Merge 4.0release.
This commit is contained in:
commit
3da0b57121
9 changed files with 160 additions and 34 deletions
|
@ -1,5 +1,10 @@
|
||||||
# all config for srs
|
# all config for srs
|
||||||
|
|
||||||
|
# The id of server, for stat and api identification.
|
||||||
|
# Note that SRS will generate a random id if not configured.
|
||||||
|
# Overwrite by env SRS_SERVER_ID
|
||||||
|
server_id srs-ie193id;
|
||||||
|
|
||||||
#############################################################################################
|
#############################################################################################
|
||||||
# RTMP sections
|
# RTMP sections
|
||||||
#############################################################################################
|
#############################################################################################
|
||||||
|
@ -126,6 +131,12 @@ tcmalloc_release_rate 0.8;
|
||||||
# Default: on
|
# Default: on
|
||||||
query_latest_version on;
|
query_latest_version on;
|
||||||
|
|
||||||
|
# First wait when qlv(query latest version), in seconds.
|
||||||
|
# Only available when qlv is enabled.
|
||||||
|
# Overwrite by env SRS_FIRST_WAIT_FOR_QLV
|
||||||
|
# Default: 300
|
||||||
|
first_wait_for_qlv 300;
|
||||||
|
|
||||||
# For thread pool.
|
# For thread pool.
|
||||||
threads {
|
threads {
|
||||||
# The thread pool manager cycle interval, in seconds.
|
# The thread pool manager cycle interval, in seconds.
|
||||||
|
|
|
@ -47,6 +47,8 @@ The changelog for SRS.
|
||||||
|
|
||||||
## SRS 4.0 Changelog
|
## SRS 4.0 Changelog
|
||||||
|
|
||||||
|
* v4.0, 2022-08-24, STAT: Support config server_id and generate one if empty. v4.0.257
|
||||||
|
* v5.0, 2022-08-24, For [#2136](https://github.com/ossrs/srs/issues/2136): API: Cleanup no active streams for statistics. v4.0.256
|
||||||
* v4.0, 2022-08-17, RTMP URL supports domain in stream parameters. v4.0.255
|
* v4.0, 2022-08-17, RTMP URL supports domain in stream parameters. v4.0.255
|
||||||
* v4.0, 2022-08-10, Fix server id generator bug. v4.0.254
|
* v4.0, 2022-08-10, Fix server id generator bug. v4.0.254
|
||||||
* v4.0, 2022-06-29, Update SRS image for r.ossrs.net. v4.0.253
|
* v4.0, 2022-06-29, Update SRS image for r.ossrs.net. v4.0.253
|
||||||
|
|
|
@ -58,6 +58,9 @@ const char* _srs_version = "XCORE-" RTMP_SIG_SRS_SERVER;
|
||||||
// '\r'
|
// '\r'
|
||||||
#define SRS_CR (char)SRS_CONSTS_CR
|
#define SRS_CR (char)SRS_CONSTS_CR
|
||||||
|
|
||||||
|
// Overwrite the config by env.
|
||||||
|
#define SRS_OVERWRITE_BY_ENV_SECONDS(key) if (getenv(key)) return ::atoi(getenv(key)) * SRS_UTIME_SECONDS
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* dumps the ingest/transcode-engine in @param dir to amf0 object @param engine.
|
* dumps the ingest/transcode-engine in @param dir to amf0 object @param engine.
|
||||||
* @param dir the transcode or ingest config directive.
|
* @param dir the transcode or ingest config directive.
|
||||||
|
@ -2385,11 +2388,11 @@ srs_error_t SrsConfig::check_normal_config()
|
||||||
&& n != "max_connections" && n != "daemon" && n != "heartbeat"
|
&& n != "max_connections" && n != "daemon" && n != "heartbeat"
|
||||||
&& n != "http_api" && n != "stats" && n != "vhost" && n != "pithy_print_ms"
|
&& n != "http_api" && n != "stats" && n != "vhost" && n != "pithy_print_ms"
|
||||||
&& n != "http_server" && n != "stream_caster" && n != "rtc_server" && n != "srt_server"
|
&& n != "http_server" && n != "stream_caster" && n != "rtc_server" && n != "srt_server"
|
||||||
&& n != "utc_time" && n != "work_dir" && n != "asprocess"
|
&& n != "utc_time" && n != "work_dir" && n != "asprocess" && n != "server_id"
|
||||||
&& n != "ff_log_level" && n != "grace_final_wait" && n != "force_grace_quit"
|
&& n != "ff_log_level" && n != "grace_final_wait" && n != "force_grace_quit"
|
||||||
&& n != "grace_start_wait" && n != "empty_ip_ok" && n != "disable_daemon_for_docker"
|
&& n != "grace_start_wait" && n != "empty_ip_ok" && n != "disable_daemon_for_docker"
|
||||||
&& n != "inotify_auto_reload" && n != "auto_reload_for_docker" && n != "tcmalloc_release_rate"
|
&& n != "inotify_auto_reload" && n != "auto_reload_for_docker" && n != "tcmalloc_release_rate"
|
||||||
&& n != "query_latest_version" && n != "threads"
|
&& n != "query_latest_version" && n != "first_wait_for_qlv" && n != "threads"
|
||||||
&& n != "circuit_breaker" && n != "is_full" && n != "in_docker"
|
&& n != "circuit_breaker" && n != "is_full" && n != "in_docker"
|
||||||
) {
|
) {
|
||||||
return srs_error_new(ERROR_SYSTEM_CONFIG_INVALID, "illegal directive %s", n.c_str());
|
return srs_error_new(ERROR_SYSTEM_CONFIG_INVALID, "illegal directive %s", n.c_str());
|
||||||
|
@ -2929,6 +2932,90 @@ SrsConfDirective* SrsConfig::get_root()
|
||||||
return root;
|
return root;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
string srs_server_id_path(string pid_file)
|
||||||
|
{
|
||||||
|
string path = srs_string_replace(pid_file, ".pid", ".id");
|
||||||
|
if (!srs_string_ends_with(path, ".id")) {
|
||||||
|
path += ".id";
|
||||||
|
}
|
||||||
|
return path;
|
||||||
|
}
|
||||||
|
|
||||||
|
string srs_try_read_file(string path) {
|
||||||
|
srs_error_t err = srs_success;
|
||||||
|
|
||||||
|
SrsFileReader r;
|
||||||
|
if ((err = r.open(path)) != srs_success) {
|
||||||
|
srs_freep(err);
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
|
||||||
|
static char buf[1024];
|
||||||
|
ssize_t nn = 0;
|
||||||
|
if ((err = r.read(buf, sizeof(buf), &nn)) != srs_success) {
|
||||||
|
srs_freep(err);
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
|
||||||
|
if (nn > 0) {
|
||||||
|
return string(buf, nn);
|
||||||
|
}
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
|
||||||
|
void srs_try_write_file(string path, string content) {
|
||||||
|
srs_error_t err = srs_success;
|
||||||
|
|
||||||
|
SrsFileWriter w;
|
||||||
|
if ((err = w.open(path)) != srs_success) {
|
||||||
|
srs_freep(err);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
if ((err = w.write((void*)content.data(), content.length(), NULL)) != srs_success) {
|
||||||
|
srs_freep(err);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
string SrsConfig::get_server_id()
|
||||||
|
{
|
||||||
|
static string DEFAULT = "";
|
||||||
|
|
||||||
|
// Try to read DEFAULT from server id file.
|
||||||
|
if (DEFAULT.empty()) {
|
||||||
|
DEFAULT = srs_try_read_file(srs_server_id_path(get_pid_file()));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Generate a random one if empty.
|
||||||
|
if (DEFAULT.empty()) {
|
||||||
|
DEFAULT = srs_generate_stat_vid();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Get the server id from env, config or DEFAULT.
|
||||||
|
string server_id;
|
||||||
|
|
||||||
|
if (getenv("SRS_SERVER_ID")) {
|
||||||
|
server_id = getenv("SRS_SERVER_ID");
|
||||||
|
}
|
||||||
|
|
||||||
|
SrsConfDirective* conf = root->get("server_id");
|
||||||
|
if (conf) {
|
||||||
|
server_id = conf->arg0();
|
||||||
|
}
|
||||||
|
|
||||||
|
if (server_id.empty()) {
|
||||||
|
server_id = DEFAULT;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Write server id to tmp file.
|
||||||
|
if (!server_id.empty()) {
|
||||||
|
srs_try_write_file(srs_server_id_path(get_pid_file()), server_id);
|
||||||
|
}
|
||||||
|
|
||||||
|
return server_id;
|
||||||
|
}
|
||||||
|
|
||||||
int SrsConfig::get_max_connections()
|
int SrsConfig::get_max_connections()
|
||||||
{
|
{
|
||||||
static int DEFAULT = 1000;
|
static int DEFAULT = 1000;
|
||||||
|
@ -3029,6 +3116,20 @@ bool SrsConfig::whether_query_latest_version()
|
||||||
return SRS_CONF_PERFER_TRUE(conf->arg0());
|
return SRS_CONF_PERFER_TRUE(conf->arg0());
|
||||||
}
|
}
|
||||||
|
|
||||||
|
srs_utime_t SrsConfig::first_wait_for_qlv()
|
||||||
|
{
|
||||||
|
SRS_OVERWRITE_BY_ENV_SECONDS("SRS_FIRST_WAIT_FOR_QLV");
|
||||||
|
|
||||||
|
static srs_utime_t DEFAULT = 5 * 60 * SRS_UTIME_SECONDS;
|
||||||
|
|
||||||
|
SrsConfDirective* conf = root->get("first_wait_for_qlv");
|
||||||
|
if (!conf) {
|
||||||
|
return DEFAULT;
|
||||||
|
}
|
||||||
|
|
||||||
|
return ::atoi(conf->arg0().c_str()) * SRS_UTIME_SECONDS;
|
||||||
|
}
|
||||||
|
|
||||||
bool SrsConfig::empty_ip_ok()
|
bool SrsConfig::empty_ip_ok()
|
||||||
{
|
{
|
||||||
static bool DEFAULT = true;
|
static bool DEFAULT = true;
|
||||||
|
|
|
@ -400,6 +400,8 @@ private:
|
||||||
// Whether user use full.conf
|
// Whether user use full.conf
|
||||||
virtual bool is_full_config();
|
virtual bool is_full_config();
|
||||||
public:
|
public:
|
||||||
|
// Get the server id, generated a random one if not configured.
|
||||||
|
virtual std::string get_server_id();
|
||||||
// Get the max connections limit of system.
|
// Get the max connections limit of system.
|
||||||
// If exceed the max connection, SRS will disconnect the connection.
|
// If exceed the max connection, SRS will disconnect the connection.
|
||||||
// @remark, linux will limit the connections of each process,
|
// @remark, linux will limit the connections of each process,
|
||||||
|
@ -431,6 +433,7 @@ public:
|
||||||
virtual bool get_asprocess();
|
virtual bool get_asprocess();
|
||||||
// Whether query the latest available version of SRS.
|
// Whether query the latest available version of SRS.
|
||||||
virtual bool whether_query_latest_version();
|
virtual bool whether_query_latest_version();
|
||||||
|
virtual srs_utime_t first_wait_for_qlv();
|
||||||
// Whether empty client IP is ok.
|
// Whether empty client IP is ok.
|
||||||
virtual bool empty_ip_ok();
|
virtual bool empty_ip_ok();
|
||||||
// Get the start wait in ms for gracefully quit.
|
// Get the start wait in ms for gracefully quit.
|
||||||
|
|
|
@ -17,6 +17,7 @@
|
||||||
#include <srs_app_http_client.hpp>
|
#include <srs_app_http_client.hpp>
|
||||||
#include <srs_app_utility.hpp>
|
#include <srs_app_utility.hpp>
|
||||||
#include <srs_app_uuid.hpp>
|
#include <srs_app_uuid.hpp>
|
||||||
|
#include <srs_app_statistic.hpp>
|
||||||
|
|
||||||
#include <unistd.h>
|
#include <unistd.h>
|
||||||
#include <sstream>
|
#include <sstream>
|
||||||
|
@ -174,20 +175,8 @@ srs_error_t SrsLatestVersion::start()
|
||||||
return srs_success;
|
return srs_success;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (true) {
|
server_id_ = SrsStatistic::instance()->server_id();
|
||||||
uuid_t uuid;
|
session_id_ = srs_generate_stat_vid();
|
||||||
uuid_generate_time(uuid);
|
|
||||||
|
|
||||||
// Must reserve last 1 byte for the trailing '\0', because we expect the size of uuid string is 32 bytes.
|
|
||||||
char buf[32 + 1];
|
|
||||||
srs_assert(16 == sizeof(uuid_t));
|
|
||||||
|
|
||||||
for (int i = 0; i < 16; i++) {
|
|
||||||
int r0 = snprintf(buf + i * 2, sizeof(buf) - i * 2, "%02x", uuid[i]);
|
|
||||||
srs_assert(r0 > 0 && r0 < (int)sizeof(buf) - i * 2);
|
|
||||||
}
|
|
||||||
server_id_ = buf;
|
|
||||||
}
|
|
||||||
|
|
||||||
return trd_->start();
|
return trd_->start();
|
||||||
}
|
}
|
||||||
|
@ -197,15 +186,10 @@ srs_error_t SrsLatestVersion::cycle()
|
||||||
srs_error_t err = srs_success;
|
srs_error_t err = srs_success;
|
||||||
|
|
||||||
if (true) {
|
if (true) {
|
||||||
srs_utime_t first_random_wait = 0;
|
srs_utime_t first_wait_for_qlv = _srs_config->first_wait_for_qlv();
|
||||||
srs_random_generate((char *) &first_random_wait, 8);
|
string pip = srs_get_public_internet_address();
|
||||||
first_random_wait = srs_utime_t(uint64_t((first_random_wait + srs_update_system_time() + getpid())) % (5 * 60)) * SRS_UTIME_SECONDS; // in s.
|
srs_trace("Startup query id=%s, session=%s, eip=%s, wait=%ds", server_id_.c_str(), session_id_.c_str(), pip.c_str(), srsu2msi(first_wait_for_qlv) / 1000);
|
||||||
|
srs_usleep(first_wait_for_qlv);
|
||||||
// Only report after 5+ minutes.
|
|
||||||
first_random_wait += 5 * 60 * SRS_UTIME_SECONDS;
|
|
||||||
|
|
||||||
srs_trace("Startup query id=%s, eip=%s, wait=%ds", server_id_.c_str(), srs_get_public_internet_address().c_str(), srsu2msi(first_random_wait) / 1000);
|
|
||||||
srs_usleep(first_random_wait);
|
|
||||||
}
|
}
|
||||||
|
|
||||||
while (true) {
|
while (true) {
|
||||||
|
@ -220,8 +204,8 @@ srs_error_t SrsLatestVersion::cycle()
|
||||||
srs_freep(err); // Ignore any error.
|
srs_freep(err); // Ignore any error.
|
||||||
}
|
}
|
||||||
|
|
||||||
srs_trace("Finish query id=%s, eip=%s, match=%s, stable=%s, cost=%dms, url=%s",
|
srs_trace("Finish query id=%s, session=%s, eip=%s, match=%s, stable=%s, cost=%dms, url=%s",
|
||||||
server_id_.c_str(), srs_get_public_internet_address().c_str(), match_version_.c_str(),
|
server_id_.c_str(), session_id_.c_str(), srs_get_public_internet_address().c_str(), match_version_.c_str(),
|
||||||
stable_version_.c_str(), srsu2msi(srs_update_system_time() - starttime), url.c_str());
|
stable_version_.c_str(), srsu2msi(srs_update_system_time() - starttime), url.c_str());
|
||||||
|
|
||||||
srs_usleep(3600 * SRS_UTIME_SECONDS); // Every an hour.
|
srs_usleep(3600 * SRS_UTIME_SECONDS); // Every an hour.
|
||||||
|
@ -238,11 +222,12 @@ srs_error_t SrsLatestVersion::query_latest_version(string& url)
|
||||||
stringstream ss;
|
stringstream ss;
|
||||||
ss << "http://api.ossrs.net/service/v1/releases?"
|
ss << "http://api.ossrs.net/service/v1/releases?"
|
||||||
<< "version=v" << VERSION_MAJOR << "." << VERSION_MINOR << "." << VERSION_REVISION
|
<< "version=v" << VERSION_MAJOR << "." << VERSION_MINOR << "." << VERSION_REVISION
|
||||||
<< "&id=" << server_id_ << "&role=srs"
|
<< "&id=" << server_id_ << "&session=" << session_id_ << "&role=srs"
|
||||||
<< "&eip=" << srs_get_public_internet_address()
|
<< "&eip=" << srs_get_public_internet_address()
|
||||||
<< "&ts=" << srs_get_system_time()
|
<< "&ts=" << srs_get_system_time()
|
||||||
<< "&alive=" << srsu2ms(srs_get_system_time() - srs_get_system_startup_time()) / 1000;
|
<< "&alive=" << srsu2ms(srs_get_system_time() - srs_get_system_startup_time()) / 1000;
|
||||||
srs_build_features(ss);
|
srs_build_features(ss);
|
||||||
|
SrsStatistic::instance()->dumps_hints_kv(ss);
|
||||||
url = ss.str();
|
url = ss.str();
|
||||||
|
|
||||||
SrsHttpUri uri;
|
SrsHttpUri uri;
|
||||||
|
|
|
@ -22,6 +22,7 @@ class SrsLatestVersion : public ISrsCoroutineHandler
|
||||||
private:
|
private:
|
||||||
SrsCoroutine* trd_;
|
SrsCoroutine* trd_;
|
||||||
std::string server_id_;
|
std::string server_id_;
|
||||||
|
std::string session_id_;
|
||||||
private:
|
private:
|
||||||
std::string match_version_;
|
std::string match_version_;
|
||||||
std::string stable_version_;
|
std::string stable_version_;
|
||||||
|
|
|
@ -206,9 +206,9 @@ SrsStatisticClient::SrsStatisticClient()
|
||||||
|
|
||||||
SrsStatisticClient::~SrsStatisticClient()
|
SrsStatisticClient::~SrsStatisticClient()
|
||||||
{
|
{
|
||||||
srs_freep(req);
|
|
||||||
srs_freep(kbps);
|
srs_freep(kbps);
|
||||||
srs_freep(clk);
|
srs_freep(clk);
|
||||||
|
srs_freep(req);
|
||||||
}
|
}
|
||||||
|
|
||||||
srs_error_t SrsStatisticClient::dumps(SrsJsonObject* obj)
|
srs_error_t SrsStatisticClient::dumps(SrsJsonObject* obj)
|
||||||
|
@ -242,8 +242,6 @@ SrsStatistic* SrsStatistic::_instance = NULL;
|
||||||
|
|
||||||
SrsStatistic::SrsStatistic()
|
SrsStatistic::SrsStatistic()
|
||||||
{
|
{
|
||||||
_server_id = srs_generate_stat_vid();
|
|
||||||
|
|
||||||
clk = new SrsWallClock();
|
clk = new SrsWallClock();
|
||||||
kbps = new SrsKbps(clk);
|
kbps = new SrsKbps(clk);
|
||||||
kbps->set_io(NULL, NULL);
|
kbps->set_io(NULL, NULL);
|
||||||
|
@ -525,7 +523,10 @@ SrsKbps* SrsStatistic::kbps_sample()
|
||||||
|
|
||||||
std::string SrsStatistic::server_id()
|
std::string SrsStatistic::server_id()
|
||||||
{
|
{
|
||||||
return _server_id;
|
if (server_id_.empty()) {
|
||||||
|
server_id_ = _srs_config->get_server_id();
|
||||||
|
}
|
||||||
|
return server_id_;
|
||||||
}
|
}
|
||||||
|
|
||||||
srs_error_t SrsStatistic::dumps_vhosts(SrsJsonArray* arr)
|
srs_error_t SrsStatistic::dumps_vhosts(SrsJsonArray* arr)
|
||||||
|
@ -593,6 +594,22 @@ srs_error_t SrsStatistic::dumps_clients(SrsJsonArray* arr, int start, int count)
|
||||||
return err;
|
return err;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
void SrsStatistic::dumps_hints_kv(std::stringstream & ss)
|
||||||
|
{
|
||||||
|
if (!streams.empty()) {
|
||||||
|
ss << "&streams=" << streams.size();
|
||||||
|
}
|
||||||
|
if (!clients.empty()) {
|
||||||
|
ss << "&clients=" << clients.size();
|
||||||
|
}
|
||||||
|
if (kbps->get_recv_kbps_30s()) {
|
||||||
|
ss << "&recv=" << kbps->get_recv_kbps_30s();
|
||||||
|
}
|
||||||
|
if (kbps->get_send_kbps_30s()) {
|
||||||
|
ss << "&send=" << kbps->get_send_kbps_30s();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
SrsStatisticVhost* SrsStatistic::create_vhost(SrsRequest* req)
|
SrsStatisticVhost* SrsStatistic::create_vhost(SrsRequest* req)
|
||||||
{
|
{
|
||||||
SrsStatisticVhost* vhost = NULL;
|
SrsStatisticVhost* vhost = NULL;
|
||||||
|
|
|
@ -12,6 +12,7 @@
|
||||||
#include <map>
|
#include <map>
|
||||||
#include <string>
|
#include <string>
|
||||||
#include <vector>
|
#include <vector>
|
||||||
|
#include <sstream>
|
||||||
|
|
||||||
#include <srs_kernel_codec.hpp>
|
#include <srs_kernel_codec.hpp>
|
||||||
#include <srs_protocol_rtmp_stack.hpp>
|
#include <srs_protocol_rtmp_stack.hpp>
|
||||||
|
@ -116,7 +117,7 @@ class SrsStatistic
|
||||||
private:
|
private:
|
||||||
static SrsStatistic *_instance;
|
static SrsStatistic *_instance;
|
||||||
// The id to identify the sever.
|
// The id to identify the sever.
|
||||||
std::string _server_id;
|
std::string server_id_;
|
||||||
private:
|
private:
|
||||||
// The key: vhost id, value: vhost object.
|
// The key: vhost id, value: vhost object.
|
||||||
std::map<std::string, SrsStatisticVhost*> vhosts;
|
std::map<std::string, SrsStatisticVhost*> vhosts;
|
||||||
|
@ -197,9 +198,14 @@ public:
|
||||||
// @param start the start index, from 0.
|
// @param start the start index, from 0.
|
||||||
// @param count the max count of clients to dump.
|
// @param count the max count of clients to dump.
|
||||||
virtual srs_error_t dumps_clients(SrsJsonArray* arr, int start, int count);
|
virtual srs_error_t dumps_clients(SrsJsonArray* arr, int start, int count);
|
||||||
|
// Dumps the hints about SRS server.
|
||||||
|
void dumps_hints_kv(std::stringstream & ss);
|
||||||
private:
|
private:
|
||||||
virtual SrsStatisticVhost* create_vhost(SrsRequest* req);
|
virtual SrsStatisticVhost* create_vhost(SrsRequest* req);
|
||||||
virtual SrsStatisticStream* create_stream(SrsStatisticVhost* vhost, SrsRequest* req);
|
virtual SrsStatisticStream* create_stream(SrsStatisticVhost* vhost, SrsRequest* req);
|
||||||
};
|
};
|
||||||
|
|
||||||
|
// Generate a random string id, with constant prefix.
|
||||||
|
extern std::string srs_generate_stat_vid();
|
||||||
|
|
||||||
#endif
|
#endif
|
||||||
|
|
|
@ -9,6 +9,6 @@
|
||||||
|
|
||||||
#define VERSION_MAJOR 4
|
#define VERSION_MAJOR 4
|
||||||
#define VERSION_MINOR 0
|
#define VERSION_MINOR 0
|
||||||
#define VERSION_REVISION 255
|
#define VERSION_REVISION 257
|
||||||
|
|
||||||
#endif
|
#endif
|
||||||
|
|
Loading…
Reference in a new issue