# Reports
## Overview
Finout Reports empowers you to create daily, weekly, or monthly reports directly from your dashboards and send them to your email, post them to Slack or MS Teams, ensuring your team stays informed on key metrics. Additionally, reports can be sent to distinct endpoints based on group-by values, allowing you to customize data delivery for each team. This makes it easy to send each team a report filtered with only their specific data to their own endpoint, enhancing relevance and accessibility for all stakeholders.
{% hint style="danger" %}
**Important**:
*Slack*:
* To send your report to Slack, configure a Slack webhook and create a Slack endpoint. For information on creating a Slack endpoint, see [Connect to Slack](https://docs.finout.io/settings/app-integrations/connect-to-slack).
*MS Teams:*
* Make sure that the user has permissions to install apps from Teams marketplace.
* Use the same Microsoft Teams account (user email address) for both the integration setup within the Finout platform and the Finout app installation on Teams.\
See [MS Teams](https://docs.finout.io/settings/app-integrations/connect-to-microsoft-teams).
*ServiceNow:*
* Make sure that the user has permissions to install apps from ServiceNow.
*Email*:
* Addresses of non-Finout users: For email addresses not linked to a Finout account, ensure you type the complete address and hit 'Enter' for the system to recognize it.
* Using distribution lists: Adding distribution lists is similar to adding individual email addresses. If the list corresponds to Finout users, the autocomplete feature will help you select it. For external lists, type and confirm the full address.
{% endhint %}
## Create a Report
You can create daily, weekly, or monthly reports from your dashboards and send them directly to your email or posted to Slack or MS Teams, ensuring your team stays up-to-date with key metrics.
**To create a report:**
1. In Finout, navigate to **Reports**.
2. Click **Create Report**.\
The **Create Report** step appears.
Note: You can also create a report by navigating to Dashboard, choosing a Dashboard, and clicking Subscribe at the top right of the page.
* Enter a **Report Name.**
* Enter a **Report** **Description**.
* Select a **Dashboard**.
Note: You may generate reports only on dashboards where you have ACL rights to the dashboard and to its underlying objects, where you have ACL rights. If those rights are later revoked, previously created reports will keep running.
* **Report Endpoints** - Choose the endpoints to where you want the report to be sent. You can set a default endpoint for the report, or you can choose to 'group by' a specific Megabill key. This allows you to send filtered reports to the corresponding endpoints set for each group-by value.\
* *Send the report to endpoints per value (Optional)*:\
Enables sending reports to endpoints based on group-by values, filtered accordingly, ensuring each segment receives data relevant to its context.\
\
**Example**: You can generate a cost report filtered by a team. This involves grouping by the virtual tag's team, using the [Virtual tag's Metadata API](https://docs.finout.io/api/finout-api/virtual-tag-metadata-api) to populate the team's virtual tag with endpoint metadata. The final report will then be sent to each team's designated endpoint.
Note: - If no specific endpoint is set per value, the report will be sent filtered by that value to the default endpoint when set. - When grouping by virtual tag, the endpoints assigned to virtual tag values through the Virtual Tag Values Metadata API are automatically populated. To learn how to set endpoints for each virtual tag value using the API, view the Virtual Tag Metadata API documentation.
.
1. Click Choose **Group By**.\
The available options appear for selection.
2. Select the desired group-by and click **Apply Group By**.\
The group by values and endpoints table appears.
Note:
When grouping by virtual tag, if virtual tag values include endpoint metadata, they will automatically be populated and updated in the “Metadata Endpoint” Column. To learn how to set endpoints for each virtual tag value using the API, view the Virtual Tag Metadata API documentation.
Your report can include a maximum of 5,000 values. Reports exceeding this limit cannot be saved.
3. You can add additional endpoints per value by clicking **Choose an endpoint** to add an additional Slack, MS Teams, and Email endpoint per value. When a value has multiple endpoints associated, a filtered report for that value is sent to all the associated endpoints.
Note: Click to disable sending reports to the metadata endpoint specified for this value in the virtual tag metadata.
* Choose a Default Endpoint (optional when group by is selected)
* Choose a Slack/MS Team endpoint or enter an email address.
1. Click **Choose Slack/MS Teams/Email endpoint.**
2. Choose a default endpoint from the dropdown list or type an email address to select an email.
Note: - When no specific endpoint is defined for a group by value, a filtered report of that value will be sent to the default endpoint when set. - Use the left toggle to disable sending a report to a specific value.
3\. **Report time frame.**
* **Dashboard default settings** - choose this option when you want to use the default time frame that is saved in the dashboard settings.
* **Custom Settings** - Choose a timeframe and the intervals:
4\. **Report Scheduling & Format**:
1. Select the report format: **Image** or **PDF**.
2. Set the Report Schedule: Choose the timeframe, frequency, and time zone for\
sending the report.
5\. Click **Test Report.**
{% hint style="info" %}
**Note**: When using group-by, the user must select both a value and an endpoint to test the report. If no group-by is applied, the report is sent as-is to the chosen endpoint.
{% endhint %}
6\. Click **Save Report**.\
Your report is saved and appears on the reports list.\
**Result:**\
A message will appear in your endpoint when a report or anomaly is triggered. For example, email:
## Manage Reports
Manage reports from the main reports page.
{% hint style="info" %}
**Note**: You can open a report in a new browser tab directly from the reports list.\
Right-click the report and select **Open in New Tab**, or use:
* **Command + Click** on macOS
* **Ctrl + Click** on Windows or Linux
This allows you to compare multiple reports side by side or keep several reports open at the same time.
{% endhint %}
1. Search all of your reports.
2. Create Report.
3. Report Name.
4. Created by - Indicates the user that created the report.
5. Endpoints - The endpoints where you want the report to be sent.
6. Group by - The selected group-by when set.
7. Created date - The date the report was created.
8. Modified date - The date the report was modified.
9. Schedule information- The schedule of when the reports are incrementally sent.
10. Active - Indicates if the report is active (Toggle on) or inactive (Toggle off).
11. Click a report to enable editing.
### Activate a Report
1. Select **Reports**.\
The reports page appears.
2. Click  to activate the required report.
### Ensure that the report is active
View the report in Slack, MS Teams, or your email. Reports sent to Slack, MS Teams, and email include:
* A direct link to the report's dashboard in Finout.
* An image/PDF (depending on the report settings) of the report's dashboard for quick reference.
### Clone Reports
1. Select **Reports**.\
The reports page appears.
2. Click **Clone Report**.\
The Report is cloned.
### Delete Reports
1. Select **Reports**.\
The reports page appears.
2. Click **Delete Report**.
The Delete this report popup appears.
3. Click **Delete**.
The report is deleted.
### Edit Reports
1. Select **Reports**.\
The reports page appears.
2. Click on the report that you want to edit.\
You are brought to **Edit Report.**
3. Make your changes.
4. Optionally, click **Test Report.**
Note: When using group-by, the user must select both a value and an endpoint to test the report. If no group-by is applied, the report is sent as-is to the chosen endpoint.
5. Click **Save Report**.\
Your report is saved and appears on the reports list.
