Cloudflare plugin
For more information about what this plugin does and the data streams it retrieves, see:
Monitor the state and performance of your Cloudflare websites.
To add a data source click on the + next to Data Sources on the left-hand menu in SquaredUp. Search for the data source and click on it to open the Configure data source page.
![Play Cloudflare video Loom video thumbnail](https://cdn.loom.com/sessions/thumbnails/3e50713d4c3a40a1a7bc522988a32377-02bab162af59c12f.gif)
Before you start
You will need a Cloudflare API Token to use this data source. This token allows SquaredUp to read data from your Cloudflare account for all websites you grant permission to.
Follow the steps below to generate a token, or for additional info please refer to the Cloudflare documentation.
Generating a token
- Go to https://dash.cloudflare.com/profile/api-tokens and log in if required.
- Select Create Token.
- Select Use Template next to the Read all resources template - this is the recommended template, but others could be used.
- Under Create Token, you can use the Edit pencil to provide a useful name for the token, e.g. SquaredUp Data Source.
- Additionally on this screen you can configure permissions. For example, if you wish to narrow down access to certain websites/zones, you can do this under Zone Resources.
- Select Continue to summary.
- Select Create token.
- Your token is now displayed, select Copy and store the token securely. You will need this when configuring the data source in SquaredUp.
Configuring the data source
Display Name:
Enter a name for your data source. This helps you to identify this data source in the list of your data sources.- API Token:
This is your Cloudflare API Token you created when generating a token. Restrict access to this data source:
You can enable this option if you only want certain users or groups to have access to the data source, or the permission to link it to new workspaces. See Access control for more information.Install Sample Dashboards:
Select whether you would like to install sample dashboards with the data source. By default, this is set to on.You can also add a data source from Settings > Data Sources > Add data source, but sample dashboards are not added when using this method.
Click Test and add to validate the data source configuration. SquaredUp will now attempt to connect to SquaredUp using the provided authentication method. If this process fails, see Testing and troubleshooting for assistance with the corresponding errors.
Testing and troubleshooting
When the data source is added (or edited), SquaredUp validates the provided API Token using the Verify Token endpoint provided by Cloudflare. Learn more.
The following errors or warnings may be displayed while using the data source. If you encounter an error, refer to the guidance below or contact [email protected] for assistance.
Next steps
Now you have successfully added the data source, you can browse the sample dashboards, view all available data streams or explore any indexed objects.
Sample dashboards
When configuring the Cloudflare data source you will have the option to Install sample dashboards. This option is recommended as the dashboards are a great starting point. The following dashboards are included with the Cloudflare data source:
- Status: Displays the health of all Websites as a large status summary. You can click on any website to drilldown and view further details.
- Website: Displays a summary report for the selected Website(s), displaying key metrics like Total Visitors, Total Requests, Data Served, Data Cached and more.
- Performance: Displays performance metrics for the selected Website(s). For example, Requests by HTTP Version, Requests by Content Type and Total Bytes by Content Type.
- Security: Displays security metrics for the selected Website(s). For example, Total Threats, Requests by SSL Mode and the Firewall Activity Log.
- Traffic: Displays traffic metrics for the selected Website(s). For example, Total Requests, Requests by Country and Page Views by Browser.
Data streams
Data streams standardize data from all the different shapes and formats your tools use into a straightforward tabular format.
While creating a tile you can tweak data streams by grouping or aggregating specific columns.
Depending on the kind of data, SquaredUp will automatically suggest how to visualize the result, for example as a table or line graph.
Data streams can be either global or scoped:
- Global data streams are unscoped and return information of a general nature (e.g. "Get the current number of unused hosts").
- A scoped data stream gets information relevant to the specific set objects supplied in the tile scope (e.g. "Get the current session count for these hosts").
See Data Streams for more information.
Objects indexed
SquaredUp indexes three types of object from your Cloudflare organization. These objects are used to build dashboards and are visible when searching across SquaredUp. Drilling down into an object will provide useful metrics and properties.
- Account
- Name, ID and Link.
- Zone (Website)
- Name, ID, Plan, Owner, Status, Name Servers, Account ID and Link.
- DNS Record
- Name, ID, Record Type, Record Content, Proxy Status and Zone ID.
Within our Map, that are relationships between all three types of objects:
Account ——contains——> Zone ——hosts——> DNS Record