2018-08-03 06:49:53 -06:00
|
|
|
# Copyright 2018 New Vector
|
|
|
|
#
|
|
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
# you may not use this file except in compliance with the License.
|
|
|
|
# You may obtain a copy of the License at
|
|
|
|
#
|
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
#
|
|
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
# See the License for the specific language governing permissions and
|
|
|
|
# limitations under the License.
|
2018-08-07 10:49:43 -06:00
|
|
|
import logging
|
2021-03-24 04:48:46 -06:00
|
|
|
from typing import Dict, List, Optional
|
2018-08-03 06:49:53 -06:00
|
|
|
|
2020-10-09 05:37:51 -06:00
|
|
|
from synapse.metrics.background_process_metrics import wrap_as_background_process
|
2019-10-21 05:56:42 -06:00
|
|
|
from synapse.storage._base import SQLBaseStore
|
2020-08-05 14:38:57 -06:00
|
|
|
from synapse.storage.database import DatabasePool, make_in_list_sql_clause
|
2018-08-06 10:51:15 -06:00
|
|
|
from synapse.util.caches.descriptors import cached
|
2018-07-31 09:36:24 -06:00
|
|
|
|
2018-08-07 10:49:43 -06:00
|
|
|
logger = logging.getLogger(__name__)
|
2018-08-06 16:25:25 -06:00
|
|
|
|
2018-08-03 10:55:50 -06:00
|
|
|
# Number of msec of granularity to store the monthly_active_user timestamp
|
|
|
|
# This means it is not necessary to update the table on every request
|
|
|
|
LAST_SEEN_GRANULARITY = 60 * 60 * 1000
|
|
|
|
|
2018-07-31 09:36:24 -06:00
|
|
|
|
2020-01-22 04:05:14 -07:00
|
|
|
class MonthlyActiveUsersWorkerStore(SQLBaseStore):
|
2020-08-05 14:38:57 -06:00
|
|
|
def __init__(self, database: DatabasePool, db_conn, hs):
|
2020-09-18 07:56:44 -06:00
|
|
|
super().__init__(database, db_conn, hs)
|
2018-07-31 09:36:24 -06:00
|
|
|
self._clock = hs.get_clock()
|
2018-08-03 06:49:53 -06:00
|
|
|
self.hs = hs
|
2020-01-22 04:05:14 -07:00
|
|
|
|
2020-10-02 06:23:15 -06:00
|
|
|
self._limit_usage_by_mau = hs.config.limit_usage_by_mau
|
|
|
|
self._max_mau_value = hs.config.max_mau_value
|
|
|
|
|
2020-01-22 04:05:14 -07:00
|
|
|
@cached(num_args=0)
|
2020-08-27 15:24:37 -06:00
|
|
|
async def get_monthly_active_count(self) -> int:
|
2020-01-22 04:05:14 -07:00
|
|
|
"""Generates current count of monthly active users
|
|
|
|
|
|
|
|
Returns:
|
2020-08-27 15:24:37 -06:00
|
|
|
Number of current monthly active users
|
2020-01-22 04:05:14 -07:00
|
|
|
"""
|
|
|
|
|
|
|
|
def _count_users(txn):
|
2020-09-29 06:11:02 -06:00
|
|
|
# Exclude app service users
|
|
|
|
sql = """
|
|
|
|
SELECT COALESCE(count(*), 0)
|
|
|
|
FROM monthly_active_users
|
|
|
|
LEFT JOIN users
|
|
|
|
ON monthly_active_users.user_id=users.name
|
|
|
|
WHERE (users.appservice_id IS NULL OR users.appservice_id = '');
|
|
|
|
"""
|
2020-01-22 04:05:14 -07:00
|
|
|
txn.execute(sql)
|
|
|
|
(count,) = txn.fetchone()
|
|
|
|
return count
|
|
|
|
|
2020-08-27 15:24:37 -06:00
|
|
|
return await self.db_pool.runInteraction("count_users", _count_users)
|
2020-01-22 04:05:14 -07:00
|
|
|
|
2020-03-06 11:14:19 -07:00
|
|
|
@cached(num_args=0)
|
2020-08-27 15:24:37 -06:00
|
|
|
async def get_monthly_active_count_by_service(self) -> Dict[str, int]:
|
2020-03-06 11:14:19 -07:00
|
|
|
"""Generates current count of monthly active users broken down by service.
|
|
|
|
A service is typically an appservice but also includes native matrix users.
|
|
|
|
Since the `monthly_active_users` table is populated from the `user_ips` table
|
|
|
|
`config.track_appservice_user_ips` must be set to `true` for this
|
|
|
|
method to return anything other than native matrix users.
|
|
|
|
|
|
|
|
Returns:
|
2020-08-27 15:24:37 -06:00
|
|
|
A mapping between app_service_id and the number of occurrences.
|
2020-03-06 11:14:19 -07:00
|
|
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
def _count_users_by_service(txn):
|
|
|
|
sql = """
|
|
|
|
SELECT COALESCE(appservice_id, 'native'), COALESCE(count(*), 0)
|
|
|
|
FROM monthly_active_users
|
|
|
|
LEFT JOIN users ON monthly_active_users.user_id=users.name
|
|
|
|
GROUP BY appservice_id;
|
|
|
|
"""
|
|
|
|
|
|
|
|
txn.execute(sql)
|
|
|
|
result = txn.fetchall()
|
|
|
|
return dict(result)
|
|
|
|
|
2020-08-27 15:24:37 -06:00
|
|
|
return await self.db_pool.runInteraction(
|
2020-08-05 14:38:57 -06:00
|
|
|
"count_users_by_service", _count_users_by_service
|
|
|
|
)
|
2020-03-06 11:14:19 -07:00
|
|
|
|
2020-06-03 10:15:57 -06:00
|
|
|
async def get_registered_reserved_users(self) -> List[str]:
|
|
|
|
"""Of the reserved threepids defined in config, retrieve those that are associated
|
|
|
|
with registered users
|
2020-01-22 04:05:14 -07:00
|
|
|
|
|
|
|
Returns:
|
2020-06-03 10:15:57 -06:00
|
|
|
User IDs of actual users that are reserved
|
2020-01-22 04:05:14 -07:00
|
|
|
"""
|
|
|
|
users = []
|
|
|
|
|
|
|
|
for tp in self.hs.config.mau_limits_reserved_threepids[
|
|
|
|
: self.hs.config.max_mau_value
|
|
|
|
]:
|
2020-06-03 10:15:57 -06:00
|
|
|
user_id = await self.hs.get_datastore().get_user_id_by_threepid(
|
2020-01-22 04:05:14 -07:00
|
|
|
tp["medium"], tp["address"]
|
|
|
|
)
|
|
|
|
if user_id:
|
|
|
|
users.append(user_id)
|
|
|
|
|
|
|
|
return users
|
|
|
|
|
|
|
|
@cached(num_args=1)
|
2021-03-24 04:48:46 -06:00
|
|
|
async def user_last_seen_monthly_active(self, user_id: str) -> Optional[int]:
|
2020-01-22 04:05:14 -07:00
|
|
|
"""
|
2020-08-26 05:19:32 -06:00
|
|
|
Checks if a given user is part of the monthly active user group
|
2020-01-22 04:05:14 -07:00
|
|
|
|
2020-08-26 05:19:32 -06:00
|
|
|
Arguments:
|
|
|
|
user_id: user to add/update
|
|
|
|
|
|
|
|
Return:
|
|
|
|
Timestamp since last seen, None if never seen
|
2020-01-22 04:05:14 -07:00
|
|
|
"""
|
|
|
|
|
2020-08-26 05:19:32 -06:00
|
|
|
return await self.db_pool.simple_select_one_onecol(
|
2020-01-22 04:05:14 -07:00
|
|
|
table="monthly_active_users",
|
|
|
|
keyvalues={"user_id": user_id},
|
|
|
|
retcol="timestamp",
|
|
|
|
allow_none=True,
|
|
|
|
desc="user_last_seen_monthly_active",
|
|
|
|
)
|
|
|
|
|
2020-10-09 05:37:51 -06:00
|
|
|
@wrap_as_background_process("reap_monthly_active_users")
|
2020-06-03 10:15:57 -06:00
|
|
|
async def reap_monthly_active_users(self):
|
2018-10-23 08:24:58 -06:00
|
|
|
"""Cleans out monthly active user table to ensure that no stale
|
2018-07-31 09:36:24 -06:00
|
|
|
entries exist.
|
|
|
|
"""
|
2019-04-03 03:07:29 -06:00
|
|
|
|
2019-10-11 02:38:26 -06:00
|
|
|
def _reap_users(txn, reserved_users):
|
|
|
|
"""
|
|
|
|
Args:
|
|
|
|
reserved_users (tuple): reserved users to preserve
|
|
|
|
"""
|
2018-08-03 06:49:53 -06:00
|
|
|
|
2019-04-03 03:07:29 -06:00
|
|
|
thirty_days_ago = int(self._clock.time_msec()) - (1000 * 60 * 60 * 24 * 30)
|
2018-08-07 10:49:43 -06:00
|
|
|
|
2020-05-22 18:20:10 -06:00
|
|
|
in_clause, in_clause_args = make_in_list_sql_clause(
|
|
|
|
self.database_engine, "user_id", reserved_users
|
|
|
|
)
|
|
|
|
|
|
|
|
txn.execute(
|
|
|
|
"DELETE FROM monthly_active_users WHERE timestamp < ? AND NOT %s"
|
|
|
|
% (in_clause,),
|
|
|
|
[thirty_days_ago] + in_clause_args,
|
|
|
|
)
|
2018-08-06 14:55:54 -06:00
|
|
|
|
2020-05-22 14:47:07 -06:00
|
|
|
if self._limit_usage_by_mau:
|
2018-11-15 11:08:27 -07:00
|
|
|
# If MAU user count still exceeds the MAU threshold, then delete on
|
|
|
|
# a least recently active basis.
|
|
|
|
# Note it is not possible to write this query using OFFSET due to
|
|
|
|
# incompatibilities in how sqlite and postgres support the feature.
|
2020-05-22 18:20:10 -06:00
|
|
|
# Sqlite requires 'LIMIT -1 OFFSET ?', the LIMIT must be present,
|
|
|
|
# while Postgres does not require 'LIMIT', but also does not support
|
2018-11-15 11:08:27 -07:00
|
|
|
# negative LIMIT values. So there is no way to write it that both can
|
|
|
|
# support
|
2019-10-11 02:38:26 -06:00
|
|
|
|
2020-05-22 18:20:10 -06:00
|
|
|
# Limit must be >= 0 for postgres
|
|
|
|
num_of_non_reserved_users_to_remove = max(
|
|
|
|
self._max_mau_value - len(reserved_users), 0
|
|
|
|
)
|
|
|
|
|
|
|
|
# It is important to filter reserved users twice to guard
|
|
|
|
# against the case where the reserved user is present in the
|
|
|
|
# SELECT, meaning that a legitimate mau is deleted.
|
|
|
|
sql = """
|
|
|
|
DELETE FROM monthly_active_users
|
|
|
|
WHERE user_id NOT IN (
|
|
|
|
SELECT user_id FROM monthly_active_users
|
|
|
|
WHERE NOT %s
|
|
|
|
ORDER BY timestamp DESC
|
|
|
|
LIMIT ?
|
2019-10-11 02:38:26 -06:00
|
|
|
)
|
2020-05-22 18:20:10 -06:00
|
|
|
AND NOT %s
|
|
|
|
""" % (
|
|
|
|
in_clause,
|
|
|
|
in_clause,
|
|
|
|
)
|
|
|
|
|
|
|
|
query_args = (
|
|
|
|
in_clause_args
|
|
|
|
+ [num_of_non_reserved_users_to_remove]
|
|
|
|
+ in_clause_args
|
|
|
|
)
|
|
|
|
txn.execute(sql, query_args)
|
|
|
|
|
|
|
|
# It seems poor to invalidate the whole cache. Postgres supports
|
2020-01-22 04:05:14 -07:00
|
|
|
# 'Returning' which would allow me to invalidate only the
|
|
|
|
# specific users, but sqlite has no way to do this and instead
|
|
|
|
# I would need to SELECT and the DELETE which without locking
|
|
|
|
# is racy.
|
|
|
|
# Have resolved to invalidate the whole cache for now and do
|
|
|
|
# something about it if and when the perf becomes significant
|
|
|
|
self._invalidate_all_cache_and_stream(
|
|
|
|
txn, self.user_last_seen_monthly_active
|
|
|
|
)
|
|
|
|
self._invalidate_cache_and_stream(txn, self.get_monthly_active_count, ())
|
|
|
|
|
2020-06-03 10:15:57 -06:00
|
|
|
reserved_users = await self.get_registered_reserved_users()
|
2020-08-05 14:38:57 -06:00
|
|
|
await self.db_pool.runInteraction(
|
2019-10-11 02:38:26 -06:00
|
|
|
"reap_monthly_active_users", _reap_users, reserved_users
|
|
|
|
)
|
2018-09-12 04:58:52 -06:00
|
|
|
|
2020-10-02 06:23:15 -06:00
|
|
|
|
|
|
|
class MonthlyActiveUsersStore(MonthlyActiveUsersWorkerStore):
|
|
|
|
def __init__(self, database: DatabasePool, db_conn, hs):
|
|
|
|
super().__init__(database, db_conn, hs)
|
|
|
|
|
|
|
|
self._mau_stats_only = hs.config.mau_stats_only
|
|
|
|
|
|
|
|
# Do not add more reserved users than the total allowable number
|
|
|
|
self.db_pool.new_transaction(
|
|
|
|
db_conn,
|
|
|
|
"initialise_mau_threepids",
|
|
|
|
[],
|
|
|
|
[],
|
|
|
|
self._initialise_reserved_users,
|
|
|
|
hs.config.mau_limits_reserved_threepids[: self._max_mau_value],
|
|
|
|
)
|
|
|
|
|
|
|
|
def _initialise_reserved_users(self, txn, threepids):
|
|
|
|
"""Ensures that reserved threepids are accounted for in the MAU table, should
|
|
|
|
be called on start up.
|
|
|
|
|
|
|
|
Args:
|
|
|
|
txn (cursor):
|
|
|
|
threepids (list[dict]): List of threepid dicts to reserve
|
|
|
|
"""
|
|
|
|
|
|
|
|
# XXX what is this function trying to achieve? It upserts into
|
|
|
|
# monthly_active_users for each *registered* reserved mau user, but why?
|
|
|
|
#
|
|
|
|
# - shouldn't there already be an entry for each reserved user (at least
|
|
|
|
# if they have been active recently)?
|
|
|
|
#
|
|
|
|
# - if it's important that the timestamp is kept up to date, why do we only
|
|
|
|
# run this at startup?
|
|
|
|
|
|
|
|
for tp in threepids:
|
|
|
|
user_id = self.get_user_id_by_threepid_txn(txn, tp["medium"], tp["address"])
|
|
|
|
|
|
|
|
if user_id:
|
|
|
|
is_support = self.is_support_user_txn(txn, user_id)
|
|
|
|
if not is_support:
|
|
|
|
# We do this manually here to avoid hitting #6791
|
|
|
|
self.db_pool.simple_upsert_txn(
|
|
|
|
txn,
|
|
|
|
table="monthly_active_users",
|
|
|
|
keyvalues={"user_id": user_id},
|
|
|
|
values={"timestamp": int(self._clock.time_msec())},
|
|
|
|
)
|
|
|
|
else:
|
|
|
|
logger.warning("mau limit reserved threepid %s not found in db" % tp)
|
|
|
|
|
2020-08-07 11:36:29 -06:00
|
|
|
async def upsert_monthly_active_user(self, user_id: str) -> None:
|
2018-10-24 10:18:08 -06:00
|
|
|
"""Updates or inserts the user into the monthly active user table, which
|
|
|
|
is used to track the current MAU usage of the server
|
|
|
|
|
|
|
|
Args:
|
2020-08-07 11:36:29 -06:00
|
|
|
user_id: user to add/update
|
2018-10-23 08:24:58 -06:00
|
|
|
"""
|
2018-12-14 11:20:59 -07:00
|
|
|
# Support user never to be included in MAU stats. Note I can't easily call this
|
|
|
|
# from upsert_monthly_active_user_txn because then I need a _txn form of
|
|
|
|
# is_support_user which is complicated because I want to cache the result.
|
|
|
|
# Therefore I call it here and ignore the case where
|
|
|
|
# upsert_monthly_active_user_txn is called directly from
|
|
|
|
# _initialise_reserved_users reasoning that it would be very strange to
|
|
|
|
# include a support user in this context.
|
|
|
|
|
2020-08-07 11:36:29 -06:00
|
|
|
is_support = await self.is_support_user(user_id)
|
2018-12-14 11:20:59 -07:00
|
|
|
if is_support:
|
|
|
|
return
|
|
|
|
|
2020-08-07 11:36:29 -06:00
|
|
|
await self.db_pool.runInteraction(
|
2019-04-03 03:07:29 -06:00
|
|
|
"upsert_monthly_active_user", self.upsert_monthly_active_user_txn, user_id
|
2018-10-23 08:24:58 -06:00
|
|
|
)
|
2018-10-25 07:58:59 -06:00
|
|
|
|
2018-10-23 08:24:58 -06:00
|
|
|
def upsert_monthly_active_user_txn(self, txn, user_id):
|
2018-10-24 10:18:08 -06:00
|
|
|
"""Updates or inserts monthly active user member
|
2018-10-25 09:13:43 -06:00
|
|
|
|
2018-12-14 11:20:59 -07:00
|
|
|
We consciously do not call is_support_txn from this method because it
|
|
|
|
is not possible to cache the response. is_support_txn will be false in
|
|
|
|
almost all cases, so it seems reasonable to call it only for
|
|
|
|
upsert_monthly_active_user and to call is_support_txn manually
|
|
|
|
for cases where upsert_monthly_active_user_txn is called directly,
|
|
|
|
like _initialise_reserved_users
|
|
|
|
|
|
|
|
In short, don't call this method with support users. (Support users
|
|
|
|
should not appear in the MAU stats).
|
|
|
|
|
2018-10-24 10:18:08 -06:00
|
|
|
Args:
|
|
|
|
txn (cursor):
|
|
|
|
user_id (str): user to add/update
|
2018-07-31 09:36:24 -06:00
|
|
|
"""
|
2018-12-14 11:20:59 -07:00
|
|
|
|
2018-09-26 09:16:41 -06:00
|
|
|
# Am consciously deciding to lock the table on the basis that is ought
|
|
|
|
# never be a big table and alternative approaches (batching multiple
|
|
|
|
# upserts into a single txn) introduced a lot of extra complexity.
|
|
|
|
# See https://github.com/matrix-org/synapse/issues/3854 for more
|
2021-07-22 05:39:50 -06:00
|
|
|
self.db_pool.simple_upsert_txn(
|
2018-10-23 08:24:58 -06:00
|
|
|
txn,
|
2018-07-31 09:36:24 -06:00
|
|
|
table="monthly_active_users",
|
2019-04-03 03:07:29 -06:00
|
|
|
keyvalues={"user_id": user_id},
|
|
|
|
values={"timestamp": int(self._clock.time_msec())},
|
2018-07-31 09:36:24 -06:00
|
|
|
)
|
2018-10-24 10:18:08 -06:00
|
|
|
|
2020-01-22 04:05:14 -07:00
|
|
|
self._invalidate_cache_and_stream(txn, self.get_monthly_active_count, ())
|
|
|
|
self._invalidate_cache_and_stream(
|
2020-03-06 11:14:19 -07:00
|
|
|
txn, self.get_monthly_active_count_by_service, ()
|
|
|
|
)
|
|
|
|
self._invalidate_cache_and_stream(
|
2020-01-22 04:05:14 -07:00
|
|
|
txn, self.user_last_seen_monthly_active, (user_id,)
|
2019-04-03 03:07:29 -06:00
|
|
|
)
|
2018-08-03 10:55:50 -06:00
|
|
|
|
2020-08-07 11:36:29 -06:00
|
|
|
async def populate_monthly_active_users(self, user_id):
|
2018-08-03 10:55:50 -06:00
|
|
|
"""Checks on the state of monthly active user limits and optionally
|
|
|
|
add the user to the monthly active tables
|
|
|
|
|
|
|
|
Args:
|
|
|
|
user_id(str): the user_id to query
|
|
|
|
"""
|
2020-05-22 14:47:07 -06:00
|
|
|
if self._limit_usage_by_mau or self._mau_stats_only:
|
2018-09-06 10:22:53 -06:00
|
|
|
# Trial users and guests should not be included as part of MAU group
|
2020-08-07 11:36:29 -06:00
|
|
|
is_guest = await self.is_guest(user_id)
|
2018-09-05 15:30:36 -06:00
|
|
|
if is_guest:
|
|
|
|
return
|
2020-08-07 11:36:29 -06:00
|
|
|
is_trial = await self.is_trial_user(user_id)
|
2018-08-23 12:17:08 -06:00
|
|
|
if is_trial:
|
|
|
|
return
|
|
|
|
|
2020-08-07 11:36:29 -06:00
|
|
|
last_seen_timestamp = await self.user_last_seen_monthly_active(user_id)
|
2018-08-03 10:55:50 -06:00
|
|
|
now = self.hs.get_clock().time_msec()
|
|
|
|
|
2018-08-06 10:51:15 -06:00
|
|
|
# We want to reduce to the total number of db writes, and are happy
|
|
|
|
# to trade accuracy of timestamp in order to lighten load. This means
|
|
|
|
# We always insert new users (where MAU threshold has not been reached),
|
|
|
|
# but only update if we have not previously seen the user for
|
|
|
|
# LAST_SEEN_GRANULARITY ms
|
2018-08-03 10:55:50 -06:00
|
|
|
if last_seen_timestamp is None:
|
2018-11-15 11:08:27 -07:00
|
|
|
# In the case where mau_stats_only is True and limit_usage_by_mau is
|
|
|
|
# False, there is no point in checking get_monthly_active_count - it
|
|
|
|
# adds no value and will break the logic if max_mau_value is exceeded.
|
2020-05-22 14:47:07 -06:00
|
|
|
if not self._limit_usage_by_mau:
|
2020-08-07 11:36:29 -06:00
|
|
|
await self.upsert_monthly_active_user(user_id)
|
2018-11-15 11:08:27 -07:00
|
|
|
else:
|
2020-08-07 11:36:29 -06:00
|
|
|
count = await self.get_monthly_active_count()
|
2020-05-22 14:47:07 -06:00
|
|
|
if count < self._max_mau_value:
|
2020-08-07 11:36:29 -06:00
|
|
|
await self.upsert_monthly_active_user(user_id)
|
2018-08-03 10:55:50 -06:00
|
|
|
elif now - last_seen_timestamp > LAST_SEEN_GRANULARITY:
|
2020-08-07 11:36:29 -06:00
|
|
|
await self.upsert_monthly_active_user(user_id)
|