--- title: "Histogram" slug: "histogram-2" tags: ["Helix Enterprise", "Reference", "Sec Ops and Analytics"] updated: 2026-09-09T16:29:16Z published: 2026-09-09T16:29:16Z canonical: "docs.trellix.com/histogram-2" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Histogram The `histogram` transform displays a bar chart or pie chart of results. > [!NOTE] > Note > > A query cannot contain both groupby and histogram transforms. > [!NOTE] > Note > > The histogram transform works only for custom dashboards. ![TAP_histogram_scap.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-e20004d2-3693-a11c-a25b-dbe3f14f3a65.png?sv=2026-02-06&spr=https&st=2026-11-20T00%3A44%3A34Z&se=2026-11-20T01%3A44%3A34Z&sr=c&sp=r&sig=xqQI15Y3FFkxs8bILhTHi1IVge7dM3eK4p9R%2F0UWEpU%3D) **Histogram syntax** `mql query | histogram <field> <period>` | `<field>` | The field determines what data is plotted. | | --- | --- | | `<period>` | The time period for the bar chart to cover. Valid values are `day`, `minute`, `hour`, and `second`. | > [!NOTE] > Note > > TQL was previously called *MQL*. You still use and see `mql` in TQL queries. **Examples** | Query | Result | | --- | --- | | `has:class \| histogram meta_ts day` | Display results for `meta_ts` for the previous 24 hours in a histogram. | | `has:class \| histogram meta_ts minute` | Display results for `meta_ts` for the past minute in a histogram. | | `has:class \| histogram meta_ts hour` | Display results for `meta_ts` for the past hour in a histogram. | | `has:class \| histogram meta_ts second` | Display results for `meta_ts` for the past second in a histogram. |