import asyncio import contextlib from datetime import datetime from functools import wraps import hashlib import json import logging import multiprocessing import os from pathlib import Path import platform import sys import textwrap import typing from typing import Any, Callable, Dict, List, Optional, Text import uuid import requests from terminaltables import SingleTable import rasa from rasa import model from rasa.constants import ( CONFIG_FILE_TELEMETRY_KEY, CONFIG_TELEMETRY_DATE, CONFIG_TELEMETRY_ENABLED, CONFIG_TELEMETRY_ID, ) from rasa.engine.storage.local_model_storage import LocalModelStorage from rasa.plugin import plugin_manager from rasa.shared.constants import DOCS_URL_TELEMETRY from rasa.shared.exceptions import RasaException import rasa.shared.utils.io from rasa.utils import common as rasa_utils import rasa.utils.io if typing.TYPE_CHECKING: from rasa.core.brokers.broker import EventBroker from rasa.core.tracker_store import TrackerStore from rasa.core.channels.channel import InputChannel from rasa.core.agent import Agent from rasa.shared.nlu.training_data.training_data import TrainingData from rasa.shared.importers.importer import TrainingDataImporter from rasa.core.utils import AvailableEndpoints logger = logging.getLogger(__name__) SEGMENT_ENDPOINT = "https://api.segment.io/v1/track" SEGMENT_REQUEST_TIMEOUT = 5 # seconds TELEMETRY_ENABLED_ENVIRONMENT_VARIABLE = "RASA_TELEMETRY_ENABLED" TELEMETRY_DEBUG_ENVIRONMENT_VARIABLE = "RASA_TELEMETRY_DEBUG" # the environment variable can be used for local development to set a test key # e.g. `RASA_TELEMETRY_WRITE_KEY=12354 rasa train` TELEMETRY_WRITE_KEY_ENVIRONMENT_VARIABLE = "RASA_TELEMETRY_WRITE_KEY" EXCEPTION_WRITE_KEY_ENVIRONMENT_VARIABLE = "RASA_EXCEPTION_WRITE_KEY" TELEMETRY_ID = "metrics_id" TELEMETRY_ENABLED_BY_DEFAULT = True # if one of these environment variables is set, we assume to be running in CI env CI_ENVIRONMENT_TELL = [ "bamboo.buildKey", "BUILD_ID", "BUILD_NUMBER", "BUILDKITE", "CI", "CIRCLECI", "CONTINUOUS_INTEGRATION", "GITHUB_ACTIONS", "HUDSON_URL", "JENKINS_URL", "TEAMCITY_VERSION", "TRAVIS", "CODEBUILD_BUILD_ARN", "CODEBUILD_BUILD_ID", "CODEBUILD_BATCH_BUILD_IDENTIFIER", ] # If updating or creating a new event, remember to update # https://rasa.com/docs/rasa/telemetry TRAINING_STARTED_EVENT = "Training Started" TRAINING_COMPLETED_EVENT = "Training Completed" TELEMETRY_DISABLED_EVENT = "Telemetry Disabled" TELEMETRY_DATA_SPLIT_EVENT = "Training Data Split" TELEMETRY_DATA_VALIDATED_EVENT = "Training Data Validated" TELEMETRY_DATA_CONVERTED_EVENT = "Training Data Converted" TELEMETRY_TRACKER_EXPORTED_EVENT = "Tracker Exported" TELEMETRY_INTERACTIVE_LEARNING_STARTED_EVENT = "Interactive Learning Started" TELEMETRY_SERVER_STARTED_EVENT = "Server Started" TELEMETRY_PROJECT_CREATED_EVENT = "Project Created" TELEMETRY_SHELL_STARTED_EVENT = "Shell Started" TELEMETRY_VISUALIZATION_STARTED_EVENT = "Story Visualization Started" TELEMETRY_TEST_CORE_EVENT = "Model Core Tested" TELEMETRY_TEST_NLU_EVENT = "Model NLU Tested" TELEMETRY_MARKERS_EXTRACTION_INITIATED_EVENT = "Markers Extraction Initiated" TELEMETRY_MARKERS_EXTRACTED_EVENT = "Markers Extracted" TELEMETRY_MARKERS_STATS_COMPUTED_EVENT = "Markers Statistics Computed" TELEMETRY_MARKERS_PARSED_COUNT = "Markers Parsed" # used to calculate the context on the first call and cache it afterwards TELEMETRY_CONTEXT = None def print_telemetry_reporting_info() -> None: """Print telemetry information to std out.""" message = textwrap.dedent( f""" Rasa Open Source reports anonymous usage telemetry to help improve the product for all its users. If you'd like to opt-out, you can use `rasa telemetry disable`. To learn more, check out {DOCS_URL_TELEMETRY}.""" ).strip() table = SingleTable([[message]]) print(table.table) def _default_telemetry_configuration(is_enabled: bool) -> Dict[Text, Any]: return { CONFIG_TELEMETRY_ENABLED: is_enabled, CONFIG_TELEMETRY_ID: uuid.uuid4().hex, CONFIG_TELEMETRY_DATE: datetime.now(), } def _write_default_telemetry_configuration( is_enabled: bool = TELEMETRY_ENABLED_BY_DEFAULT, ) -> bool: new_config = _default_telemetry_configuration(is_enabled) success = rasa_utils.write_global_config_value( CONFIG_FILE_TELEMETRY_KEY, new_config ) # Do not show info if user has enabled/disabled telemetry via env var telemetry_environ = os.environ.get(TELEMETRY_ENABLED_ENVIRONMENT_VARIABLE) if is_enabled and success and telemetry_environ is None: print_telemetry_reporting_info() return success def _is_telemetry_enabled_in_configuration() -> bool: """Read telemetry configuration from the user's Rasa config file in $HOME. Creates a default configuration if no configuration exists. Returns: `True`, if telemetry is enabled, `False` otherwise. """ try: stored_config = rasa_utils.read_global_config_value( CONFIG_FILE_TELEMETRY_KEY, unavailable_ok=False ) return stored_config[CONFIG_TELEMETRY_ENABLED] except ValueError as e: logger.debug(f"Could not read telemetry settings from configuration file: {e}") # seems like there is no config, we'll create one and enable telemetry success = _write_default_telemetry_configuration() # if writing the configuration failed, telemetry will be disabled return TELEMETRY_ENABLED_BY_DEFAULT and success def is_telemetry_enabled() -> bool: """Check if telemetry is enabled either in configuration or environment. Returns: `True`, if telemetry is enabled, `False` otherwise. """ telemetry_environ = os.environ.get(TELEMETRY_ENABLED_ENVIRONMENT_VARIABLE) if telemetry_environ is not None: return telemetry_environ.lower() == "true" try: return rasa_utils.read_global_config_value( CONFIG_FILE_TELEMETRY_KEY, unavailable_ok=False )[CONFIG_TELEMETRY_ENABLED] except ValueError: return False def initialize_telemetry() -> bool: """Read telemetry configuration from the user's Rasa config file in $HOME. Creates a default configuration if no configuration exists. Returns: `True`, if telemetry is enabled, `False` otherwise. """ try: # calling this even if the environment variable is set makes sure the # configuration is created and there is a telemetry ID is_enabled_in_configuration = _is_telemetry_enabled_in_configuration() telemetry_environ = os.environ.get(TELEMETRY_ENABLED_ENVIRONMENT_VARIABLE) if telemetry_environ is None: return is_enabled_in_configuration return telemetry_environ.lower() == "true" except Exception as e: # skipcq:PYL-W0703 logger.exception( f"Failed to initialize telemetry reporting: {e}." f"Telemetry reporting will be disabled." ) return False def ensure_telemetry_enabled(f: Callable[..., Any]) -> Callable[..., Any]: """Function decorator for telemetry functions that ensures telemetry is enabled. WARNING: does not work as a decorator for async generators. Args: f: function to call if telemetry is enabled Returns: Return wrapped function """ # allows us to use the decorator for async and non async functions if asyncio.iscoroutinefunction(f): @wraps(f) async def decorated_coroutine(*args: Any, **kwargs: Any) -> Any: if is_telemetry_enabled(): return await f(*args, **kwargs) return None return decorated_coroutine @wraps(f) def decorated(*args: Any, **kwargs: Any) -> Any: if is_telemetry_enabled(): return f(*args, **kwargs) return None return decorated def _fetch_write_key(tool: Text, environment_variable: Text) -> Optional[Text]: """Read the write key from a tool from our set of keys. Args: tool: name of the tool we want to fetch a key for environment_variable: name of the environment variable to set the key Returns: write key, if a key was present. """ import pkg_resources from rasa import __name__ as name if os.environ.get(environment_variable): # a write key set using the environment variable will always # overwrite any key provided as part of the package (`keys` file) return os.environ.get(environment_variable) write_key_path = pkg_resources.resource_filename(name, "keys") # noinspection PyBroadException try: with open(write_key_path) as f: return json.load(f).get(tool) except Exception: # skipcq:PYL-W0703 return None def telemetry_write_key() -> Optional[Text]: """Read the Segment write key from the segment key text file. The segment key text file should by present only in wheel/sdist packaged versions of Rasa Open Source. This avoids running telemetry locally when developing on Rasa or when running CI builds. In local development, this should always return `None` to avoid logging telemetry. Returns: Segment write key, if the key file was present. """ return _fetch_write_key("segment", TELEMETRY_WRITE_KEY_ENVIRONMENT_VARIABLE) def sentry_write_key() -> Optional[Text]: """Read the sentry write key from the sentry key text file. Returns: Sentry write key, if the key file was present. """ return _fetch_write_key("sentry", EXCEPTION_WRITE_KEY_ENVIRONMENT_VARIABLE) def _encode_base64(original: Text, encoding: Text = "utf-8") -> Text: """Encodes a string as a base64 string. Args: original: Text to be encoded. encoding: Encoding used to convert text to binary. Returns: Encoded text. """ import base64 return base64.b64encode(original.encode(encoding)).decode(encoding) def segment_request_header(write_key: Text) -> Dict[Text, Any]: """Use a segment write key to create authentication headers for the segment API. Args: write_key: Authentication key for segment. Returns: Authentication headers for segment. """ return { "Authorization": "Basic {}".format(_encode_base64(write_key + ":")), "Content-Type": "application/json", } def segment_request_payload( distinct_id: Text, event_name: Text, properties: Dict[Text, Any], context: Dict[Text, Any], ) -> Dict[Text, Any]: """Compose a valid payload for the segment API. Args: distinct_id: Unique telemetry ID. event_name: Name of the event. properties: Values to report along the event. context: Context information about the event. Returns: Valid segment payload. """ return { "userId": distinct_id, "event": event_name, "properties": properties, "context": context, } def in_continuous_integration() -> bool: """Returns `True` if currently running inside a continuous integration context.""" return any(env in os.environ for env in CI_ENVIRONMENT_TELL) def _is_telemetry_debug_enabled() -> bool: """Check if telemetry debug mode is enabled.""" return ( os.environ.get(TELEMETRY_DEBUG_ENVIRONMENT_VARIABLE, "false").lower() == "true" ) def print_telemetry_event(payload: Dict[Text, Any]) -> None: """Print a telemetry events payload to the commandline. Args: payload: payload of the event """ print("Telemetry Event:") print(json.dumps(payload, indent=2)) def _send_event( distinct_id: Text, event_name: Text, properties: Dict[Text, Any], context: Dict[Text, Any], ) -> None: """Report the contents segmentof an event to the /track Segment endpoint. Documentation: https://.com/docs/sources/server/http/ Do not call this function from outside telemetry.py! This function does not check if telemetry is enabled or not. Args: distinct_id: Unique telemetry ID. event_name: Name of the event. properties: Values to report along the event. context: Context information about the event. """ payload = segment_request_payload(distinct_id, event_name, properties, context) if _is_telemetry_debug_enabled(): print_telemetry_event(payload) return write_key = telemetry_write_key() if not write_key: # If TELEMETRY_WRITE_KEY is empty or `None`, telemetry has not been # enabled for this build (e.g. because it is running from source) logger.debug("Skipping request to external service: telemetry key not set.") return if "license_hash" not in context: # only send telemetry data for customers logger.debug("Skipping telemetry reporting: no license hash found.") return headers = segment_request_header(write_key) resp = requests.post( SEGMENT_ENDPOINT, headers=headers, json=payload, timeout=SEGMENT_REQUEST_TIMEOUT ) # handle different failure cases if resp.status_code != 200: logger.debug( f"Segment telemetry request returned a {resp.status_code} response. " f"Body: {resp.text}" ) else: data = resp.json() if not data.get("success"): logger.debug( f"Segment telemetry request returned a failure. Response: {data}" ) def _hash_directory_path(path: Text) -> Optional[Text]: """Create a hash for the directory. Returns: hash of the directories path """ full_path = Path(path).absolute() return hashlib.sha256(str(full_path).encode("utf-8")).hexdigest() # noinspection PyBroadException def _is_docker() -> bool: """Guess if we are running in docker environment. Returns: `True` if we are running inside docker, `False` otherwise. """ # first we try to use the env try: os.stat("/.dockerenv") return True except Exception: # skipcq:PYL-W0703 pass # if that didn't work, try to use proc information try: return "docker" in rasa.shared.utils.io.read_file("/proc/self/cgroup", "utf8") except Exception: # skipcq:PYL-W0703 return False def with_default_context_fields( context: Optional[Dict[Text, Any]] = None ) -> Dict[Text, Any]: """Return a new context dictionary with default and provided field values merged. The default fields contain only the OS information for now. Args: context: Context information about the event. Return: A new context. """ context = context or {} return {**_default_context_fields(), **context} def _default_context_fields() -> Dict[Text, Any]: """Return a dictionary that contains the default context values. Return: A new context containing information about the runtime environment. """ global TELEMETRY_CONTEXT if not TELEMETRY_CONTEXT: # Make sure to update the example in docs/docs/telemetry/telemetry.mdx # if you change / add context TELEMETRY_CONTEXT = { "os": {"name": platform.system(), "version": platform.release()}, "ci": in_continuous_integration(), "project": model.project_fingerprint(), "directory": _hash_directory_path(os.getcwd()), "python": sys.version.split(" ")[0], "rasa_open_source": rasa.__version__, "cpu": multiprocessing.cpu_count(), "docker": _is_docker(), } license_hash = plugin_manager().hook.get_license_hash() if license_hash: TELEMETRY_CONTEXT["license_hash"] = license_hash # avoid returning the cached dict --> caller could modify the dictionary... # usually we would use `lru_cache`, but that doesn't return a dict copy and # doesn't work on inner functions, so we need to roll our own caching... return TELEMETRY_CONTEXT.copy() def _track( event_name: Text, properties: Optional[Dict[Text, Any]] = None, context: Optional[Dict[Text, Any]] = None, ) -> None: """Tracks a telemetry event. It is OK to use this function from outside telemetry.py, but note that it is recommended to create a new track_xyz() function for complex telemetry events, or events that are generated from many parts of the Rasa Open Source code. Args: event_name: Name of the event. properties: Dictionary containing the event's properties. context: Dictionary containing some context for this event. """ try: telemetry_id = get_telemetry_id() if not telemetry_id: logger.debug("Will not report telemetry events as no ID was found.") return if not properties: properties = {} properties[TELEMETRY_ID] = telemetry_id _send_event( telemetry_id, event_name, properties, with_default_context_fields(context) ) except Exception as e: # skipcq:PYL-W0703 logger.debug(f"Skipping telemetry reporting: {e}") def get_telemetry_id() -> Optional[Text]: """Return the unique telemetry identifier for this Rasa Open Source install. The identifier can be any string, but it should be a UUID. Returns: The identifier, if it is configured correctly. """ try: telemetry_config = ( rasa_utils.read_global_config_value(CONFIG_FILE_TELEMETRY_KEY) or {} ) return telemetry_config.get(CONFIG_TELEMETRY_ID) except Exception as e: # skipcq:PYL-W0703 logger.debug(f"Unable to retrieve telemetry ID: {e}") return None def toggle_telemetry_reporting(is_enabled: bool) -> None: """Write to the configuration if telemetry tracking should be enabled or disabled. Args: is_enabled: `True` if the telemetry reporting should be enabled, `False` otherwise. """ configuration = rasa_utils.read_global_config_value(CONFIG_FILE_TELEMETRY_KEY) if configuration: configuration[CONFIG_TELEMETRY_ENABLED] = is_enabled else: configuration = _default_telemetry_configuration(is_enabled) rasa_utils.write_global_config_value(CONFIG_FILE_TELEMETRY_KEY, configuration) def filter_errors( event: Optional[Dict[Text, Any]], hint: Optional[Dict[Text, Any]] = None ) -> Optional[Dict[Text, Any]]: """Filter errors. Args: event: event to be logged to sentry hint: some hinting information sent alongside of the event Returns: the event without any sensitive / PII data or `None` if the event constitutes an `ImportError` which should be discarded. """ if hint and "exc_info" in hint: exc_type, exc_value, tb = hint["exc_info"] if isinstance(exc_value, ImportError): return None return event def before_send( event: Dict[Text, Any], _unused_hint: Optional[Dict[Text, Any]] = None ) -> Optional[Dict[Text, Any]]: """Strips the sensitive data and filters errors before sending to sentry. Args: event: event to be logged to sentry _unused_hint: some hinting information sent alongside of the event Returns: the event without any sensitive / PII data or `None` if the event should be discarded. """ cleaned_event = strip_sensitive_data_from_sentry_event(event, _unused_hint) return filter_errors(cleaned_event, _unused_hint) def strip_sensitive_data_from_sentry_event( event: Dict[Text, Any], _unused_hint: Optional[Dict[Text, Any]] = None ) -> Optional[Dict[Text, Any]]: """Remove any sensitive data from the event (e.g. path names). Args: event: event to be logged to sentry _unused_hint: some hinting information sent alongside of the event Returns: the event without any sensitive / PII data or `None` if the event should be discarded. """ # removes any paths from stack traces (avoids e.g. sending # a users home directory name if package is installed there) for value in event.get("exception", {}).get("values", []): for frame in value.get("stacktrace", {}).get("frames", []): frame["abs_path"] = "" if f"rasa_sdk{os.path.sep}executor.py" in frame["filename"]: # this looks a lot like an exception in the SDK and hence custom code # no need for us to deal with that return None elif "site-packages" in frame["filename"]: # drop site-packages and following slash / backslash relative_name = frame["filename"].split("site-packages")[-1][1:] frame["filename"] = os.path.join("site-packages", relative_name) elif "dist-packages" in frame["filename"]: # drop dist-packages and following slash / backslash relative_name = frame["filename"].split("dist-packages")[-1][1:] frame["filename"] = os.path.join("dist-packages", relative_name) elif os.path.isabs(frame["filename"]): # if the file path is absolute, we'll drop the whole event as this is # very likely custom code. needs to happen after cleaning as # site-packages / dist-packages paths are also absolute, but fine. return None return event @ensure_telemetry_enabled def initialize_error_reporting() -> None: """Sets up automated error reporting. Exceptions are reported to sentry. We avoid sending any metadata (local variables, paths, ...) to make sure we don't compromise any data. Only the exception and its stacktrace is logged and only if the exception origins from the `rasa` package. """ import sentry_sdk from sentry_sdk import configure_scope from sentry_sdk.integrations.atexit import AtexitIntegration from sentry_sdk.integrations.dedupe import DedupeIntegration from sentry_sdk.integrations.excepthook import ExcepthookIntegration # key for local testing can be found at # https://sentry.io/settings/rasahq/projects/rasa-open-source/install/python/ # for local testing, set the key using `RASA_EXCEPTION_WRITE_KEY=key rasa ` key = sentry_write_key() if not key: return telemetry_id = get_telemetry_id() # this is a very defensive configuration, avoiding as many integrations as # possible. it also submits very little data (exception with error message # and line numbers). sentry_sdk.init( f"https://{key}.ingest.sentry.io/2801673", before_send=before_send, integrations=[ ExcepthookIntegration(), DedupeIntegration(), AtexitIntegration(lambda _, __: None), ], send_default_pii=False, # activate PII filter server_name=telemetry_id or "UNKNOWN", ignore_errors=[ # std lib errors KeyboardInterrupt, # user hit the interrupt key (Ctrl+C) MemoryError, # machine is running out of memory NotImplementedError, # user is using a feature that is not implemented asyncio.CancelledError, # an async operation has been cancelled by the user # expected Rasa errors RasaException, OSError, ], in_app_include=["rasa"], # only submit errors in this package with_locals=False, # don't submit local variables release=f"rasa-{rasa.__version__}", default_integrations=False, environment="development" if in_continuous_integration() else "production", ) if not telemetry_id: return with configure_scope() as scope: # sentry added these more recently, just a protection in a case where a # user has installed an older version of sentry if hasattr(scope, "set_user"): scope.set_user({"id": telemetry_id}) default_context = _default_context_fields() if hasattr(scope, "set_context"): if "os" in default_context: # os is a nested dict, hence we report it separately scope.set_context("Operating System", default_context.pop("os")) scope.set_context("Environment", default_context) @contextlib.contextmanager def track_model_training( training_data: "TrainingDataImporter", model_type: Text, is_finetuning: bool = False ) -> typing.Generator[None, None, None]: """Track a model training started. WARNING: since this is a generator, it can't use the ensure telemetry decorator. We need to manually add these checks here. This can be fixed as soon as we drop python 3.6 support. Args: training_data: Training data used for the training. model_type: Specifies the type of training, should be either "rasa", "core" or "nlu". is_finetuning: `True` if the model is trained by finetuning another model. """ if not initialize_telemetry(): # telemetry reporting is disabled. we won't do any reporting yield # runs the training return config = training_data.get_config() stories = training_data.get_stories() nlu_data = training_data.get_nlu_data() domain = training_data.get_domain() count_conditional_responses = domain.count_conditional_response_variations() ( count_total_mappings, count_custom_mappings, count_conditional_mappings, ) = domain.count_slot_mapping_statistics() training_id = uuid.uuid4().hex # Make sure to update the example in docs/docs/telemetry/telemetry.mdx # if you change / add any properties _track( TRAINING_STARTED_EVENT, { "language": config.get("language"), "training_id": training_id, "type": model_type, "pipeline": config.get("pipeline"), "policies": config.get("policies"), "train_schema": config.get("train_schema"), "predict_schema": config.get("predict_schema"), "num_intent_examples": len(nlu_data.intent_examples), "num_entity_examples": len(nlu_data.entity_examples), "num_actions": len(domain.action_names_or_texts), # Old nomenclature from when 'responses' were still called # 'templates' in the domain "num_templates": len(domain.responses), "num_conditional_response_variations": count_conditional_responses, "num_slot_mappings": count_total_mappings, "num_custom_slot_mappings": count_custom_mappings, "num_conditional_slot_mappings": count_conditional_mappings, "num_slots": len(domain.slots), "num_forms": len(domain.forms), "num_intents": len(domain.intents), "num_entities": len(domain.entities), "num_story_steps": len(stories.story_steps), "num_lookup_tables": len(nlu_data.lookup_tables), "num_synonyms": len(nlu_data.entity_synonyms), "num_regexes": len(nlu_data.regex_features), "is_finetuning": is_finetuning, "recipe": config.get("recipe"), }, ) start = datetime.now() yield runtime = datetime.now() - start _track( TRAINING_COMPLETED_EVENT, { "training_id": training_id, "type": model_type, "runtime": int(runtime.total_seconds()), }, ) @ensure_telemetry_enabled def track_telemetry_disabled() -> None: """Track when a user disables telemetry.""" _track(TELEMETRY_DISABLED_EVENT) @ensure_telemetry_enabled def track_data_split(fraction: float, data_type: Text) -> None: """Track when a user splits data. Args: fraction: How much data goes into train and how much goes into test data_type: Is this core, nlu or nlg data """ _track(TELEMETRY_DATA_SPLIT_EVENT, {"fraction": fraction, "type": data_type}) @ensure_telemetry_enabled def track_validate_files(validation_success: bool) -> None: """Track when a user validates data files. Args: validation_success: Whether the validation was successful """ _track(TELEMETRY_DATA_VALIDATED_EVENT, {"validation_success": validation_success}) @ensure_telemetry_enabled def track_data_convert(output_format: Text, data_type: Text) -> None: """Track when a user converts data. Args: output_format: Target format for the converter data_type: Is this core, nlu or nlg data """ _track( TELEMETRY_DATA_CONVERTED_EVENT, {"output_format": output_format, "type": data_type}, ) @ensure_telemetry_enabled def track_tracker_export( number_of_exported_events: int, tracker_store: "TrackerStore", event_broker: "EventBroker", ) -> None: """Track when a user exports trackers. Args: number_of_exported_events: Number of events that got exported tracker_store: Store used to retrieve the events from event_broker: Broker the events are getting published towards """ _track( TELEMETRY_TRACKER_EXPORTED_EVENT, { "number_of_exported_events": number_of_exported_events, "tracker_store": type(tracker_store).__name__, "event_broker": type(event_broker).__name__, }, ) @ensure_telemetry_enabled def track_interactive_learning_start( skip_visualization: bool, save_in_e2e: bool ) -> None: """Track when a user starts an interactive learning session. Args: skip_visualization: Is visualization skipped in this session save_in_e2e: Is e2e used in this session """ _track( TELEMETRY_INTERACTIVE_LEARNING_STARTED_EVENT, {"skip_visualization": skip_visualization, "save_in_e2e": save_in_e2e}, ) @ensure_telemetry_enabled def track_server_start( input_channels: List["InputChannel"], endpoints: Optional["AvailableEndpoints"], model_directory: Optional[Text], number_of_workers: int, is_api_enabled: bool, ) -> None: """Tracks when a user starts a rasa server. Args: input_channels: Used input channels endpoints: Endpoint configuration for the server model_directory: directory of the running model number_of_workers: number of used Sanic workers is_api_enabled: whether the rasa API server is enabled """ from rasa.core.utils import AvailableEndpoints def project_fingerprint_from_model( _model_directory: Optional[Text], ) -> Optional[Text]: """Gets project fingerprint from an app's loaded model.""" if not model_directory: return None try: model_archive = model.get_local_model(_model_directory) metadata = LocalModelStorage.metadata_from_archive(model_archive) return metadata.project_fingerprint except Exception: return None if not endpoints: endpoints = AvailableEndpoints() _track( TELEMETRY_SERVER_STARTED_EVENT, { "input_channels": [i.name() for i in input_channels], "api_enabled": is_api_enabled, "number_of_workers": number_of_workers, "endpoints_nlg": endpoints.nlg.type if endpoints.nlg else None, "endpoints_nlu": endpoints.nlu.type if endpoints.nlu else None, "endpoints_action_server": endpoints.action.type if endpoints.action else None, "endpoints_model_server": endpoints.model.type if endpoints.model else None, "endpoints_tracker_store": endpoints.tracker_store.type if endpoints.tracker_store else None, "endpoints_lock_store": endpoints.lock_store.type if endpoints.lock_store else None, "endpoints_event_broker": endpoints.event_broker.type if endpoints.event_broker else None, "project": project_fingerprint_from_model(model_directory), }, ) @ensure_telemetry_enabled def track_project_init(path: Text) -> None: """Track when a user creates a project using rasa init. Args: path: Location of the project """ _track( TELEMETRY_PROJECT_CREATED_EVENT, {"init_directory": _hash_directory_path(path)} ) @ensure_telemetry_enabled def track_shell_started(model_type: Text) -> None: """Track when a user starts a bot using rasa shell. Args: model_type: Type of the model, core / nlu or rasa. """ _track(TELEMETRY_SHELL_STARTED_EVENT, {"type": model_type}) @ensure_telemetry_enabled def track_visualization() -> None: """Track when a user runs the visualization.""" _track(TELEMETRY_VISUALIZATION_STARTED_EVENT) @ensure_telemetry_enabled def track_core_model_test(num_story_steps: int, e2e: bool, agent: "Agent") -> None: """Track when a user tests a core model. Args: num_story_steps: Number of test stories used for the comparison e2e: indicator if tests running in end to end mode agent: Agent of the model getting tested """ if agent.processor is None: project_fingerprint = "" else: project_fingerprint = agent.processor.model_metadata.project_fingerprint _track( TELEMETRY_TEST_CORE_EVENT, { "project": project_fingerprint, "end_to_end": e2e, "num_story_steps": num_story_steps, }, ) @ensure_telemetry_enabled def track_nlu_model_test(test_data: "TrainingData") -> None: """Track when a user tests an nlu model. Args: test_data: Data used for testing """ _track( TELEMETRY_TEST_NLU_EVENT, { "num_intent_examples": len(test_data.intent_examples), "num_entity_examples": len(test_data.entity_examples), "num_lookup_tables": len(test_data.lookup_tables), "num_synonyms": len(test_data.entity_synonyms), "num_regexes": len(test_data.regex_features), }, ) @ensure_telemetry_enabled def track_markers_extraction_initiated( strategy: Text, only_extract: bool, seed: bool, count: Optional[int] ) -> None: """Track when a user tries to extract success markers. Args: strategy: The strategy the user is using for tracker selection only_extract: Indicates if the user is only extracting markers or also producing stats seed: Indicates if the user used a seed for this attempt count: (Optional) The number of trackers the user is trying to select. """ _track( TELEMETRY_MARKERS_EXTRACTION_INITIATED_EVENT, { "strategy": strategy, "only_extract": only_extract, "seed": seed, "count": count, }, ) @ensure_telemetry_enabled def track_markers_extracted(trackers_count: int) -> None: """Track when markers have been extracted by a user. Args: trackers_count: The actual number of trackers processed """ _track(TELEMETRY_MARKERS_EXTRACTED_EVENT, {"trackers_count": trackers_count}) @ensure_telemetry_enabled def track_markers_stats_computed(trackers_count: int) -> None: """Track when stats over markers have been computed by a user. Args: trackers_count: The actual number of trackers processed """ _track(TELEMETRY_MARKERS_STATS_COMPUTED_EVENT, {"trackers_count": trackers_count}) @ensure_telemetry_enabled def track_markers_parsed_count( marker_count: int, max_depth: int, branching_factor: int ) -> None: """Track when markers have been successfully parsed from config. Args: marker_count: The number of markers found in the config max_depth: The maximum depth of any marker in the config branching_factor: The maximum number of children of any marker in the config. """ _track( TELEMETRY_MARKERS_PARSED_COUNT, { "marker_count": marker_count, "max_depth": max_depth, "branching_factor": branching_factor, }, )