Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

docs: usage analytics updates (#74386)

Alex Yaroshdeb0ba16b1dc
diff --git a/docs/configuring-metabase/settings.md b/docs/configuring-metabase/settings.md
index 37e9f22415f..a364f1fb96a 100644
--- a/docs/configuring-metabase/settings.md
+++ b/docs/configuring-metabase/settings.md
@@ -11,7 +11,6 @@ _Admin > Settings > General_
This section contains settings for your whole instance, like its URL, the reporting timezone, and toggles for disabling or enabling some of Metabase's optional features.
You can configure these settings by clicking the **grid icon** in the upper right, then going to **Admin** > **Settings** > **General**.
-
## Site name
How you’d like to refer to this instance of Metabase.
@@ -40,10 +39,20 @@ To revert to the default Metabase homepage, simply toggle off Custom homepage.
This email address will be displayed in various messages throughout Metabase when users encounter a scenario where they need assistance from an admin, such as a password reset request.
-## Anonymous tracking
+## Usage tracking
+
+### Send anonymous tracking data to Metabase
On self-hosted Metabases, this option determines whether or not you allow [anonymous data about your usage of Metabase](../installation-and-operation/information-collection.md) to be sent back to us to help us improve the product. [Your database’s data is never tracked or sent](https://www.metabase.com/security).
+### Collect user data to display in usage analytics
+
+{% include plans-blockquote.html feature="Collecting user data" %}
+
+You can switch on logging of IP addresses, user agents, embed path, query parameters, and Metabot conversation metadata for people using your Metabase, both for people directly by logging into Metabase, or for people who view an embedded Metabase component in your app. If enabled, you can find this information in your [usage analytics](../usage-and-performance-tools/usage-analytics.md).
+
+By default, collection of user data is turned **off**.
+
## Friendly table and field names
By default, Metabase attempts to make field and table names more readable by changing things like `somehorriblename` to `Some Horrible Name`. This does not work well for languages other than English, or for fields that have lots of abbreviations or codes in them. If you'd like to turn this setting off, you can do so from the Admin Panel under **Admin** **> Settings** > **General**.
diff --git a/docs/embedding/introduction.md b/docs/embedding/introduction.md
index af7b66f29e1..c19d04debd3 100644
--- a/docs/embedding/introduction.md
+++ b/docs/embedding/introduction.md
@@ -94,6 +94,12 @@ The modular embeds that you can set up in the [in-app wizard](./modular-embeddin
If you're using an AI agent to help you embed Metabase in your app, check out [AI agent resources](./ai-agent-resources.md).
+## Tracking embed usage
+
+{% include plans-blockquote.html feature="Tracking embed usage" %}
+
+[Usage Analytics](../usage-and-performance-tools/usage-analytics.md) tracks embed usage, including embedding context, authentication methods, hostname, and other metadata. Check out the [Embedding usage dashboard](../usage-and-performance-tools/usage-analytics-reference.md#embedding-usage).
+
## Further reading
- [Strategies for delivering customer-facing analytics](https://www.metabase.com/learn/metabase-basics/embedding/overview).