> For the complete documentation index, see [llms.txt](https://clients.medianova.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://clients.medianova.com/products/edgesight/analytics/connecting-a-source.md).

# Connecting a Source

Learn how to connect Medianova, Cloudflare, or Akamai as a data source and configure your Edgesight Analytics workspace.

Connect a CDN source to Edgesight Analytics to begin processing CDN access logs and populating your Grafana dashboards.

The first source creates the Analytics workspace and defines its dashboards, Grafana address, users, and access rules. Additional sources are connected to the same workspace and use the existing configuration.

Edgesight Analytics supports the following CDN sources:

* **Medianova**
* **Cloudflare**
* **Akamai**

{% hint style="info" %}
Your Edgesight Analytics plan determines the number of sources you can connect, the available CDN providers, and the supported data retention period.
{% endhint %}

## Before You Begin

Before connecting your first source, select your Edgesight Analytics plan and storage region.

The **storage region** determines where Analytics data is stored and therefore controls data residency. It is configured at the organization level and applies to all sources connected to the workspace.

The selected storage region is displayed as read-only during source configuration.

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2F027LgqYdpHfcSfNyUGUA%2Fimage.png?alt=media&amp;token=1936947f-a805-4524-a97d-c28c776236e0" alt=""><figcaption><p>The Analytics introduction screen, before any source is connected.</p></figcaption></figure>

{% hint style="warning" %}
An organization uses a single Analytics workspace. The workspace subdomain, dashboard users, and IP whitelist are configured when the first source is connected and are shared by sources added later.
{% endhint %}

## Connect Your First Source

In the [Medianova Control Panel](https://cloud.medianova.com), go to **Edgesight → Analytics**.

The initial setup consists of five stages:

{% stepper %}
{% step %}

### Select a CDN Source

Select the CDN provider whose logs you want to analyze:

* **Medianova**
* **Cloudflare**
* **Akamai**

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2FSm4J2qE7nPWDa9tJS9HQ%2Fimage.png?alt=media&amp;token=7faf0ab8-182d-4550-b1d9-8e45f293ba2e" alt=""><figcaption><p>Step 1 - choosing which CDN this source reads.</p></figcaption></figure>

The selected provider determines how log data is delivered to Edgesight Analytics.
{% endstep %}

{% step %}

### Configure Dashboards

All available dashboards are selected by default. Remove dashboards you do not need and configure the storage settings for each enabled dashboard.

Edgesight Analytics provides:

* **Overview**
* **Performance Analytics**
* **HTTP & Cache Analytics**
* **Bot Analytics**

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2FYaeCcMdits7WtcTfEUOS%2Fimage.png?alt=media&amp;token=966cd33d-af74-442e-9a17-1731e2886699" alt=""><figcaption><p>Step 2 - every dashboard is included by default, with its own retention and granularity.</p></figcaption></figure>

Each dashboard has its own **Retention** and **Granularity** settings.

**Retention** defines how long data for the dashboard is stored.

**Granularity** defines the resolution at which aggregated data is stored, from one minute to one day. Finer granularity provides more detail for short time ranges, while coarser granularity is suitable for longer-term analysis.

At least one dashboard must remain enabled.

{% hint style="info" %}
Retention and granularity determine how dashboard data is stored. A dashboard cannot display historical data that was not retained.
{% endhint %}
{% endstep %}

{% step %}

### Configure Workspace Settings

Configure the Analytics workspace.

This step appears only when connecting the **first source**.

<table><thead><tr><th width="167">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Source Name</strong></td><td>A recognizable name for the CDN source in the Medianova Control Panel.</td></tr><tr><td><strong>Subdomain</strong></td><td>Defines the Grafana workspace address. Lowercase letters, numbers, and hyphens are supported. Availability is checked during configuration.</td></tr><tr><td><strong>IP Whitelist</strong></td><td>Optionally restricts workspace access to specified IP addresses or CIDR ranges.</td></tr><tr><td><strong>Dashboard Users</strong></td><td>Defines the accounts that can sign in to Grafana. At least one dashboard user is required.</td></tr></tbody></table>

The Grafana address is generated from the configured subdomain:

`https://<your-subdomain>-analytics.medianova.com`

Dashboard user passwords must contain at least **eight characters**.

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2FP1aVL5HCrssq1V2sm4gW%2Fimage.png?alt=media&amp;token=a9599830-35d8-490d-aeea-423304518c74" alt=""><figcaption></figcaption></figure>

If the IP whitelist is left empty, the Grafana workspace can be reached from any IP address.

{% hint style="warning" %}
Dashboard users have read access to the provided dashboards. They cannot edit dashboard panels or create new dashboards.
{% endhint %}
{% endstep %}

{% step %}

### Review the Configuration

Review the configuration before deployment.

The review includes:

* Source and workspace name
* Grafana address
* Enabled dashboards
* Retention and granularity settings
* Dashboard users
* IP whitelist rules

Confirm the configuration to begin provisioning.
{% endstep %}

{% step %}

### Deploy the Workspace

Edgesight Analytics automatically provisions the workspace and its supporting services.

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2Fe7O90HHAp7gy5Nc2sBkP%2Fimage.png?alt=media&amp;token=27b09736-c960-4bb2-96b7-04fd3c6e2643" alt="" width="353"><figcaption><p>Provisioning in progress, with each step reporting as it completes.</p></figcaption></figure>

The deployment process includes:

<table><thead><tr><th width="229.6666259765625">Stage</th><th>Description</th></tr></thead><tbody><tr><td><strong>Creating instance</strong></td><td>Reserves the Analytics workspace.</td></tr><tr><td><strong>Preparing data store</strong></td><td>Creates the storage structures used by Analytics.</td></tr><tr><td><strong>Connecting pipeline</strong></td><td>Starts the CDN log ingestion pipeline.</td></tr><tr><td><strong>Configuring datasets</strong></td><td>Creates the aggregated datasets used by the dashboards.</td></tr><tr><td><strong>Provisioning access</strong></td><td>Creates the required read-only data access credentials.</td></tr><tr><td><strong>Deploying dashboards</strong></td><td>Deploys Grafana and the selected dashboards.</td></tr><tr><td><strong>Configuring DNS</strong></td><td>Publishes the Grafana address and configures its certificate.</td></tr><tr><td><strong>Creating users &#x26; verifying</strong></td><td>Creates dashboard users and verifies the workspace.</td></tr></tbody></table>

Provisioning progress is displayed in the Medianova Control Panel and updates as each stage completes.

{% hint style="info" %}
Provisioning usually takes a few minutes. DNS configuration may affect the total deployment time.
{% endhint %}
{% endstep %}
{% endstepper %}

## Provider-Specific Configuration

Log delivery differs depending on the CDN provider.

#### Medianova

For a Medianova source, sign in with your Medianova account when prompted and select the organization whose CDN traffic you want to analyze.

No external log delivery configuration is required. Edgesight Analytics retrieves the required data through your Medianova account.

#### Cloudflare

For a Cloudflare source, Edgesight Analytics creates a dedicated ingest URL and API token after the source is provisioned.

Configure a **Cloudflare Logpush** job with:

* The provided ingest URL as the HTTP destination.
* The provided token in the `apikey` header.

#### Akamai

For an Akamai source, Edgesight Analytics also provides a dedicated ingest URL and API token.

Configure **Akamai DataStream** with:

* HTTPS delivery to the provided ingest URL.
* The provided token in the required header.

<table><thead><tr><th width="190">Provider</th><th>Log Delivery</th></tr></thead><tbody><tr><td><strong>Medianova</strong></td><td>Retrieved through the connected Medianova account.</td></tr><tr><td><strong>Cloudflare</strong></td><td>Logpush using the provided HTTP ingest URL and <code>apikey</code> header.</td></tr><tr><td><strong>Akamai</strong></td><td>DataStream using HTTPS delivery with the provided ingest URL and authentication header.</td></tr></tbody></table>

{% hint style="warning" %}
Copy the API token when it is displayed. The token is scoped to the source's ingest endpoint. If the token is lost, rotate it to generate a new token. Rotation immediately invalidates the previous token.
{% endhint %}

## After Deployment

When provisioning is complete, the Analytics summary page becomes the main management interface for the workspace.

From this page, you can:

* Select an individual source or **All Sources**.
* Select **Open Grafana** to open the dashboards in a new tab.
* Select **Connect a CDN** to add another source.
* Review workspace access and users.
* Monitor data usage for each dashboard.

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2FbC2GDGTIfMSVryCztGx8%2Fimage.png?alt=media&amp;token=7478aa75-7d2e-4a72-8f50-863d6436063b" alt=""><figcaption><p>The Analytics summary you land on once your first source is live - source switcher, Open Grafana and Connect a CDN.</p></figcaption></figure>

Dashboards begin receiving data after the source starts sending traffic. Newly deployed dashboards may initially contain limited data while the aggregated datasets are populated.

## Add Another Source

To connect another CDN to an existing workspace, select **Connect a CDN** from the Analytics summary page.

For additional sources, you only need to:

1. Select the CDN provider.
2. Enter a source name.
3. Complete the provider-specific connection.

Dashboard selection, workspace subdomain, dashboard users, and IP whitelist settings are not configured again. The new source uses the existing workspace configuration.

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2F6AHQk3l5h4HZCVYRu1LV%2Fimage.png?alt=media&amp;token=c7e1ba39-09bc-4a4f-955f-4b2d76451e1f" alt=""><figcaption></figcaption></figure>

After the source is connected, it becomes available in the source selector. Select **All Sources** to analyze supported metrics from multiple CDN sources in the same dashboards.

{% hint style="info" %}
Adding another source does not create another Grafana workspace. All connected CDN sources use the organization's existing Edgesight Analytics workspace.
{% endhint %}

## Next Steps

* [**Your Dashboards**](/products/edgesight/analytics/your-dashboards.md) — Review the available dashboards, metrics, retention, and granularity.
* [**Access & Management**](/products/edgesight/analytics/access-and-management.md) — Manage dashboard users, IP access, and workspace settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://clients.medianova.com/products/edgesight/analytics/connecting-a-source.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.