Report Builder
The Report Builder lets you quickly aggregate data from your search results. It helps you identify values of interest and statistical outliers, supporting deeper investigation and analysis. To limit the results to only the services or endpoints that match your query, check the Filter my results to display services or endpoints that match my query box.
This guide walks you through the steps to generate a report using the Censys Platform.
Generate a report
-
Go to https://platform.censys.io.
-
Enter the required query, and click Search.
Censys returns all matching results.
Note
You can also create reports from the filter sidebar.
-
Click the Report Builder tab in the navigation bar.
-
Click Select Breakdown. To find the field you want to use, type its name and select it from the dropdown.
- For example:
host.services.port
.
- For example:
-
Use the Results dropdown to select how many buckets of aggregated values you want in your report.
-
Decide whether to filter the report aggregations based on your query by checking the Filter my results to display services or endpoints that match my query box.
Filtering examplesExample 1
If your query ishost.services.protocol=SSH
, and you break down the report byhost.services.port
:- Unchecked box: Your report will include all ports used by any protocol on hosts that matched your SSH query.
- Checked box: Your report will only include SSH-specific ports, those that match the protocol in your original query.
Example 2
If your query isweb.endpoints: (http.status_code >= "200" and http.status_code <= "204")
, and you break down the report byweb.endpoints.http.status_code
:- Unchecked box: The report may include status codes outside the 200 to 204 range, because other endpoints on the same web properties could return different codes.
- Checked box: Only status codes within the 200 to 204 range will be included.
-
-
Click Generate Report.
The output will appear in a table format. -
To export the report, click JSON to download it.
Updated 4 days ago