Monitor your proxy usage and traffic patterns and spot issues before they become problems.
The Usage Analytics dashboard gives you a detailed breakdown of how your proxies are being used. You can find it by clicking the bar chart icon in the left sidebar, or going to Usage breakdown.
Filtering by date range
Use the date picker at the top of the page to change the time window. The summary cards and chart both update to reflect whichever range you select. This is useful for comparing a specific week or day against your baseline.
The summary cards
At the top of the page, three cards give you a snapshot of activity for the selected time range.
Total credits
The total number of credits consumed in the selected period. Credits are deducted based on the volume of traffic you route through SOAX and the country tier you target. If this number is higher than expected, the usage log below will help you narrow down which package or country is driving it.
Total traffic
The total data transferred through your proxies, shown in GB. This is the raw volume your credits are spent on. A spike here is worth investigating in the chart.
Credits/GB avg
Your average credits spent per GB in the selected period.This reflects the blend of country tiers you’ve been targeting. A higher number means more traffic through Tier 1 countries (US, UK, Western Europe), which cost more per GB. A lower number means more Tier 2 or Tier 3 traffic. If it’s trending up, check the Country and Tier filters in the usage insights to see what’s shifted.
Usage insights
The chart section lets you slice your traffic data to understand exactly where consumption is coming from.
Filters
You can filter the chart and table by:
Proxy package — isolate traffic from a specific package if you’re running multiple
Proxy network — filter by network type (e.g. residential)
Tier — see how much of your traffic is going through Tier 1, 2, or 3 countries
Country — drill down to a specific country
Interval — switch between daily, weekly, or hourly granularity
Filters stack, so you can combine them — for example, residential traffic in Tier 1 countries over the last 7 days.
Reading the chart
The Usage over time chart shows traffic volume in GB or consumed credits (toggle with the Gb / Credits buttons in the top right) broken down by your chosen grouping. By default it groups by package, with each package shown as a separate colour in the stacked columns.Switch between Columns and Lines views depending on what you’re trying to see:
Columns make it easy to compare total volume across days
Lines make it easier to see trends and rate of change over time
Use Group by to pivot the view — grouping by Country or Tier is useful when you want to understand your geographic cost distribution.
A sudden spike on a single day usually means a job ran with misconfigured session settings, or a retry loop sent far more requests than intended. Cross-reference the date in the usage log to find the package and egress IP involved.
Usage log
Below the chart, the usage log gives you a row-by-row record of traffic activity. Each row represents an aggregated record for a specific combination of package, network, tier, country, egress IP, and domain as well as month / date / hour.The columns are:
Column
What it tells you
Date
When the traffic occurred
Package
Which proxy package was used (shown as a UUID)
Network
The proxy network type (e.g. residential)
Tier
The country tier (1, 2, or 3) — this determines the per-GB rate
Country
The country code of the exit node used
Egress IP
The specific proxy IP the traffic exited through
Domain
The target domain that was requested
Traffic
Data transferred for that record, in GB
Exporting data
Click Export CSV in the top right of the usage log to download the full log for the current filter and date range. This is useful for reconciling usage against your own application logs, or sharing consumption data with your team.Use All columns selected to choose which columns to include in the export before downloading.
How to spot issues
A few patterns worth knowing:Unexpectedly high traffic on a single day — check the usage log filtered to that date. Look for a high-traffic egress IP or a domain you don’t recognise. This often points to a misconfigured retry loop or a job that ran longer than expected.Credits/GB avg is higher than your plan rate — this means you’re routing traffic through more expensive country tiers than you intended. Filter the chart by Tier to confirm, then check whether your proxy configuration is targeting the right countries.Traffic spread across many egress IPs to the same domain — this is normal for rotating proxy sessions. If you’re seeing it on a session-based package, it may indicate your session duration is too short and connections are cycling more often than expected.No traffic showing for a package — if a package shows zero usage when you expect some, check that the package is active in Package Management and that your credentials are correct. Authentication failures don’t generate usage records.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SOAX","colors":{"primary":"#10b77f","light":"#128e65","dark":"#10b77f"},"logo":{"light":"https://mintcdn.com/soax/x2dnBPUF6XiNROo6/logo/logo-wide-black.svg?fit=max\u0026auto=format\u0026n=x2dnBPUF6XiNROo6\u0026q=85\u0026s=8e1801c906e292ef153e926f6a0eb1f2","dark":"https://mintcdn.com/soax/x2dnBPUF6XiNROo6/logo/logo-wide-white.svg?fit=max\u0026auto=format\u0026n=x2dnBPUF6XiNROo6\u0026q=85\u0026s=0c6611fc658f1ec64bf928c6ecf1a105","href":"https://soax.com"},"favicon":"https://mintcdn.com/soax/x2dnBPUF6XiNROo6/logo/favicon.svg?fit=max\u0026auto=format\u0026n=x2dnBPUF6XiNROo6\u0026q=85\u0026s=82cf944d568d4b5bc1bca2be2b4fba7b","background":{"color":{"light":"#f8f7f7","dark":"#131316"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","grok","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"soax","hasAudioNarration":false,"actualSubdomain":"soax","customDomains":["developers.soax.com"],"gitSource":{"type":"github","owner":"soax-org","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af5d9ddcf5b122bc79c5507","clientVersion":"0.0.4128","searchFilterCounts":[{"language":"default","tag":"API Reference","count":34},{"language":"default","tag":"Locations","count":8},{"language":"default","tag":"Stateful Sessions","count":7},{"language":"default","tag":"Troubleshooting","count":7},{"language":"default","tag":"Trust \u0026 Safety","count":6},{"language":"default","tag":"Code Examples","count":5},{"language":"default","tag":"Getting Started","count":5},{"language":"default","tag":"API Keys","count":4},{"language":"default","tag":"Packages","count":4},{"language":"default","tag":"Dashboard","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"dashboard/usage-analytics","slug":"/dashboard/usage-analytics","pageMetadata":{"title":"Usage Analytics","description":"Monitor your proxy usage and traffic patterns and spot issues before they become problems.","href":"/dashboard/usage-analytics"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Monitor your proxy usage and traffic patterns and spot issues before they become problems.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Table,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The Usage Analytics dashboard gives you a detailed breakdown of how your proxies are being used. You can find it by clicking the bar chart icon in the left sidebar, or going to `,_jsx(_components.a,{href:`https://platform.soax.com/usage`,children:`Usage breakdown`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`filtering-by-date-range`,children:`Filtering by date range`}),`\n`,_jsx(_components.p,{children:`Use the date picker at the top of the page to change the time window. The summary cards and chart both update to reflect whichever range you select. This is useful for comparing a specific week or day against your baseline.`}),`\n`,_jsx(Heading,{level:`2`,id:`the-summary-cards`,children:`The summary cards`}),`\n`,_jsx(_components.p,{children:`At the top of the page, three cards give you a snapshot of activity for the selected time range.`}),`\n`,_jsx(Heading,{level:`3`,id:`total-credits`,children:`Total credits`}),`\n`,_jsx(_components.p,{children:`The total number of credits consumed in the selected period. Credits are deducted based on the volume of traffic you route through SOAX and the country tier you target. If this number is higher than expected, the usage log below will help you narrow down which package or country is driving it.`}),`\n`,_jsx(Heading,{level:`3`,id:`total-traffic`,children:`Total traffic`}),`\n`,_jsx(_components.p,{children:`The total data transferred through your proxies, shown in GB. This is the raw volume your credits are spent on. A spike here is worth investigating in the chart.`}),`\n`,_jsx(Heading,{level:`3`,id:`credits/gb-avg`,children:`Credits/GB avg`}),`\n`,_jsx(_components.p,{children:`Your average credits spent per GB in the selected period.`}),`\n`,_jsxs(_components.p,{children:[`This reflects the blend of country tiers you’ve been targeting. A higher number means more traffic through Tier 1 countries (US, UK, Western Europe), which cost more per GB. A lower number means more Tier 2 or Tier 3 traffic. If it’s trending up, check the `,_jsx(_components.strong,{children:`Country`}),` and `,_jsx(_components.strong,{children:`Tier`}),` filters in the usage insights to see what’s shifted.`]}),`\n`,_jsx(Heading,{level:`2`,id:`usage-insights`,children:`Usage insights`}),`\n`,_jsx(_components.p,{children:`The chart section lets you slice your traffic data to understand exactly where consumption is coming from.`}),`\n`,_jsx(Heading,{level:`3`,id:`filters`,children:`Filters`}),`\n`,_jsx(_components.p,{children:`You can filter the chart and table by:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Proxy package`}),` — isolate traffic from a specific package if you’re running multiple`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Proxy network`}),` — filter by network type (e.g. residential)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Tier`}),` — see how much of your traffic is going through Tier 1, 2, or 3 countries`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Country`}),` — drill down to a specific country`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Interval`}),` — switch between daily, weekly, or hourly granularity`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Filters stack, so you can combine them — for example, residential traffic in Tier 1 countries over the last 7 days.`}),`\n`,_jsx(Heading,{level:`3`,id:`reading-the-chart`,children:`Reading the chart`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Usage over time`}),` chart shows traffic volume in GB or consumed credits (toggle with the `,_jsx(_components.strong,{children:`Gb / Credits`}),` buttons in the top right) broken down by your chosen grouping. By default it groups by package, with each package shown as a separate colour in the stacked columns.`]}),`\n`,_jsxs(_components.p,{children:[`Switch between `,_jsx(_components.strong,{children:`Columns`}),` and `,_jsx(_components.strong,{children:`Lines`}),` views depending on what you’re trying to see:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Columns`}),` make it easy to compare total volume across days`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Lines`}),` make it easier to see trends and rate of change over time`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`Group by`}),` to pivot the view — grouping by `,_jsx(_components.strong,{children:`Country`}),` or `,_jsx(_components.strong,{children:`Tier`}),` is useful when you want to understand your geographic cost distribution.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`A sudden spike on a single day usually means a job ran with misconfigured session settings, or a retry loop sent far more requests than intended. Cross-reference the date in the usage log to find the package and egress IP involved.`})}),`\n`,_jsx(Heading,{level:`2`,id:`usage-log`,children:`Usage log`}),`\n`,_jsx(_components.p,{children:`Below the chart, the usage log gives you a row-by-row record of traffic activity. Each row represents an aggregated record for a specific combination of package, network, tier, country, egress IP, and domain as well as month / date / hour.`}),`\n`,_jsx(_components.p,{children:`The columns are:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Column`}),_jsx(_components.th,{children:`What it tells you`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Date`})}),_jsx(_components.td,{children:`When the traffic occurred`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Package`})}),_jsx(_components.td,{children:`Which proxy package was used (shown as a UUID)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Network`})}),_jsx(_components.td,{children:`The proxy network type (e.g. residential)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Tier`})}),_jsx(_components.td,{children:`The country tier (1, 2, or 3) — this determines the per-GB rate`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Country`})}),_jsx(_components.td,{children:`The country code of the exit node used`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Egress IP`})}),_jsx(_components.td,{children:`The specific proxy IP the traffic exited through`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Domain`})}),_jsx(_components.td,{children:`The target domain that was requested`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Traffic`})}),_jsx(_components.td,{children:`Data transferred for that record, in GB`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`exporting-data`,children:`Exporting data`}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Export CSV`}),` in the top right of the usage log to download the full log for the current filter and date range. This is useful for reconciling usage against your own application logs, or sharing consumption data with your team.`]}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`All columns selected`}),` to choose which columns to include in the export before downloading.`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-to-spot-issues`,children:`How to spot issues`}),`\n`,_jsx(_components.p,{children:`A few patterns worth knowing:`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Unexpectedly high traffic on a single day`}),` — check the usage log filtered to that date. Look for a high-traffic egress IP or a domain you don’t recognise. This often points to a misconfigured retry loop or a job that ran longer than expected.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Credits/GB avg is higher than your plan rate`}),` — this means you’re routing traffic through more expensive country tiers than you intended. Filter the chart by `,_jsx(_components.strong,{children:`Tier`}),` to confirm, then check whether your proxy configuration is targeting the right countries.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Traffic spread across many egress IPs to the same domain`}),` — this is normal for rotating proxy sessions. If you’re seeing it on a session-based package, it may indicate your session duration is too short and connections are cycling more often than expected.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`No traffic showing for a package`}),` — if a package shows zero usage when you expect some, check that the package is active in `,_jsx(_components.strong,{children:`Package Management`}),` and that your credentials are correct. Authentication failures don’t generate usage records.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Usage Analytics","description":"Monitor your proxy usage and traffic patterns and spot issues before they become problems.","href":"/dashboard/usage-analytics"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Filtering by date range","slug":"filtering-by-date-range","depth":2,"children":[]},{"title":"The summary cards","slug":"the-summary-cards","depth":2,"children":[{"title":"Total credits","slug":"total-credits","depth":3,"children":[]},{"title":"Total traffic","slug":"total-traffic","depth":3,"children":[]},{"title":"Credits/GB avg","slug":"credits/gb-avg","depth":3,"children":[]}]},{"title":"Usage insights","slug":"usage-insights","depth":2,"children":[{"title":"Filters","slug":"filters","depth":3,"children":[]},{"title":"Reading the chart","slug":"reading-the-chart","depth":3,"children":[]}]},{"title":"Usage log","slug":"usage-log","depth":2,"children":[{"title":"Exporting data","slug":"exporting-data","depth":3,"children":[]}]},{"title":"How to spot issues","slug":"how-to-spot-issues","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"soax","siteName":"SOAX","title":"Usage Analytics - SOAX","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T11:49:13.110Z","originalFileLocation":"dashboard/usage-analytics.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Monitor your proxy usage and traffic patterns and spot issues before they become problems.\">\u003cmeta data-mint-head name=\"application-name\" content=\"SOAX\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/soax/xEvn0n-A8DsILfj7/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/soax/xEvn0n-A8DsILfj7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/soax/xEvn0n-A8DsILfj7/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/soax/xEvn0n-A8DsILfj7/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/soax/xEvn0n-A8DsILfj7/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/soax/xEvn0n-A8DsILfj7/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/soax/xEvn0n-A8DsILfj7/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/soax/xEvn0n-A8DsILfj7/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/soax/xEvn0n-A8DsILfj7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Usage Analytics - SOAX\">\u003cmeta data-mint-head property=\"og:description\" content=\"Monitor your proxy usage and traffic patterns and spot issues before they become problems.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SOAX\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.soax.com/dashboard/usage-analytics\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://soax.mintlify.site/_mintlify/api/og/v2?division=Dashboard\u0026amp;title=Usage+Analytics\u0026amp;description=Monitor+your+proxy+usage+and+traffic+patterns+and+spot+issues+before+they+become+problems.\u0026amp;theme=526423948ae0103100b8c638\u0026amp;signature=b48df80568790b0fa59dc09fce91765cb6f8fec87e14e921fdd0afca047ea355\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Usage Analytics - SOAX\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Monitor your proxy usage and traffic patterns and spot issues before they become problems.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://soax.mintlify.site/_mintlify/api/og/v2?division=Dashboard\u0026amp;title=Usage+Analytics\u0026amp;description=Monitor+your+proxy+usage+and+traffic+patterns+and+spot+issues+before+they+become+problems.\u0026amp;theme=526423948ae0103100b8c638\u0026amp;signature=b48df80568790b0fa59dc09fce91765cb6f8fec87e14e921fdd0afca047ea355\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/soax/xEvn0n-A8DsILfj7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SOAX\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#10b77f\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.soax.com/dashboard/usage-analytics\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/dashboard/usage-analytics.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.soax.com/#organization\",\"name\":\"SOAX\",\"url\":\"https://developers.soax.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/soax/x2dnBPUF6XiNROo6/logo/logo-wide-black.svg?fit=max\u0026auto=format\u0026n=x2dnBPUF6XiNROo6\u0026q=85\u0026s=8e1801c906e292ef153e926f6a0eb1f2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.soax.com#website\",\"name\":\"SOAX\",\"url\":\"https://developers.soax.com\",\"publisher\":{\"@id\":\"https://developers.soax.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.soax.com/dashboard/usage-analytics#webpage\",\"url\":\"https://developers.soax.com/dashboard/usage-analytics\",\"name\":\"Usage Analytics\",\"description\":\"Monitor your proxy usage and traffic patterns and spot issues before they become problems.\",\"dateModified\":\"2026-11-12T11:49:13.110Z\",\"isPartOf\":{\"@id\":\"https://developers.soax.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.soax.com/dashboard/usage-analytics#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.soax.com/dashboard/usage-analytics#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Dashboard\",\"item\":\"https://developers.soax.com/dashboard/quick-connect\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Usage Analytics\",\"item\":\"https://developers.soax.com/dashboard/usage-analytics\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.soax.com/dashboard/usage-analytics#article\",\"headline\":\"Usage Analytics\",\"name\":\"Usage Analytics\",\"description\":\"Monitor your proxy usage and traffic patterns and spot issues before they become problems.\",\"url\":\"https://developers.soax.com/dashboard/usage-analytics\",\"mainEntityOfPage\":{\"@id\":\"https://developers.soax.com/dashboard/usage-analytics#webpage\"},\"dateModified\":\"2026-11-12T11:49:13.110Z\",\"publisher\":{\"@id\":\"https://developers.soax.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.soax.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SOAX\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"SOAX\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/dashboard/usage-analytics.md","siteName":"SOAX","nav":{"global":null,"groups":[{"group":"Getting Started","pages":[{"title":"What is SOAX","href":"/getting-started/what-is-soax"},{"title":"Quickstart","href":"/getting-started/quickstart"},{"title":"Core Concepts","href":"/getting-started/core-concepts"},{"title":"Choosing the Right Proxy Type","href":"/getting-started/choosing-proxy-type"},{"title":"Authentication","href":"/getting-started/authentication"}]},{"group":"Proxies","pages":[{"title":"Residential Proxies","href":"/proxies/residential"},{"title":"Mobile Proxies","href":"/proxies/mobile"},{"title":"Stateful Sessions","href":"/proxies/stateful-sessions"}]},{"group":"Dashboard","pages":[{"title":"Quick Connect","href":"/dashboard/quick-connect"},{"title":"Package Management","description":"Create, configure, and manage proxy packages from the dashboard. Packages are the unit of access and billing — credentials, limits, and entitlements all live on a package.","href":"/dashboard/package-management"},{"title":"Usage Analytics","href":"/dashboard/usage-analytics"},{"title":"Account \u0026 Billing","description":"Manage your subscription, payment methods, and invoices — and understand how traffic and overages are calculated.","href":"/dashboard/account-billing"}]},{"group":"Trust \u0026 Safety","pages":[{"title":"Responsible web access","href":"/trust/responsible-web-access"},{"title":"Customer screening \u0026 verification","href":"/trust/customer-screening"},{"title":"Access restrictions","href":"/trust/access-restrictions"},{"title":"Requesting additional access","href":"/trust/additional-access"},{"title":"Network sourcing \u0026 consent","href":"/trust/network-sourcing"},{"title":"Acceptable use \u0026 abuse response","href":"/trust/acceptable-use"}]},{"group":"API Reference","pages":[{"title":"API overview","href":"/api/overview"},{"title":"API quickstart","href":"/api/quickstart"},{"title":"API authentication","href":"/api/authentication"},{"title":"Error handling","href":"/api/errors"},{"title":"Rate limits","href":"/api/rate-limits"},{"group":"API Keys","pages":[{"title":"Get current API key","openapi":"api/openapi.json GET /v1/api-keys/me","href":"/api/keys/me"},{"title":"List API keys","openapi":"api/openapi.json GET /v1/api-keys/","href":"/api/keys/list"},{"title":"Create an API key","openapi":"api/openapi.json POST /v1/api-keys/","href":"/api/keys/create"},{"title":"Revoke an API key","openapi":"api/openapi.json DELETE /v1/api-keys/{key_id}","href":"/api/keys/revoke"}]},{"group":"Packages","pages":[{"title":"List packages","openapi":"api/openapi.json GET /v1/proxy/packages","href":"/api/packages/list"},{"title":"Get a package","openapi":"api/openapi.json GET /v1/proxy/packages/{package_id}","href":"/api/packages/get"},{"title":"Get connection strings","openapi":"api/openapi.json GET /v1/proxy/packages/{package_id}/connection-string","href":"/api/packages/connection-string"},{"title":"Rotate package password","openapi":"api/openapi.json POST /v1/proxy/packages/{package_id}/rotate-password","href":"/api/packages/rotate-password"}]},{"group":"Stateful Sessions","pages":[{"title":"Create stateful sessions","openapi":"api/openapi.json POST /v1/proxy/packages/{package_id}/stateful-sessions","href":"/api/stateful-sessions/create"},{"title":"List stateful sessions","openapi":"api/openapi.json GET /v1/proxy/packages/{package_id}/stateful-sessions","href":"/api/stateful-sessions/list"},{"title":"Get a stateful session","openapi":"api/openapi.json GET /v1/proxy/packages/{package_id}/stateful-sessions/{session_id}","href":"/api/stateful-sessions/get"},{"title":"Update a stateful session","openapi":"api/openapi.json PATCH /v1/proxy/packages/{package_id}/stateful-sessions/{session_id}","href":"/api/stateful-sessions/update"},{"title":"Rotate a stateful session","openapi":"api/openapi.json POST /v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate","href":"/api/stateful-sessions/rotate"},{"title":"Delete a stateful session","openapi":"api/openapi.json DELETE /v1/proxy/packages/{package_id}/stateful-sessions/{session_id}","href":"/api/stateful-sessions/delete"},{"title":"Delete stateful sessions in bulk","openapi":"api/openapi.json POST /v1/proxy/packages/{package_id}/stateful-sessions/delete","href":"/api/stateful-sessions/bulk-delete"}]},{"group":"Locations","pages":[{"title":"List proxy tiers","openapi":"api/openapi.json GET /v1/proxy/locations/tiers","href":"/api/locations/tiers"},{"title":"List proxy countries","openapi":"api/openapi.json GET /v1/proxy/locations/countries","href":"/api/locations/countries"},{"title":"List package countries","openapi":"api/openapi.json GET /v1/proxy/packages/{package_id}/locations/countries","href":"/api/locations/package-countries"},{"title":"List package regions","openapi":"api/openapi.json GET /v1/proxy/packages/{package_id}/locations/countries/{cc}/regions","href":"/api/locations/package-regions"},{"title":"List package cities","openapi":"api/openapi.json GET /v1/proxy/packages/{package_id}/locations/countries/{cc}/cities","href":"/api/locations/package-cities"},{"title":"List package ISPs","openapi":"api/openapi.json GET /v1/proxy/packages/{package_id}/locations/countries/{cc}/isps","href":"/api/locations/package-isps"},{"title":"List package ASNs","openapi":"api/openapi.json GET /v1/proxy/packages/{package_id}/locations/countries/{cc}/asns","href":"/api/locations/package-asns"},{"title":"List package ZIP codes","openapi":"api/openapi.json GET /v1/proxy/packages/{package_id}/locations/countries/{cc}/zip-codes","href":"/api/locations/package-zip-codes"}]},{"group":"Account","pages":[{"title":"Get account","openapi":"api/openapi.json GET /v1/account","href":"/api/account/get"},{"title":"List credit blocks","openapi":"api/openapi.json GET /v1/account/credits","href":"/api/account/credits"},{"title":"Get subscription","openapi":"api/openapi.json GET /v1/account/subscription","href":"/api/account/subscription"}]},{"group":"Analytics","pages":[{"title":"Usage summary","openapi":"api/openapi.json POST /v1/proxy/analytics/summary","href":"/api/analytics/summary"},{"title":"Traffic breakdown","openapi":"api/openapi.json POST /v1/proxy/analytics/traffic","href":"/api/analytics/traffic"},{"title":"Credits burned","openapi":"api/openapi.json POST /v1/proxy/analytics/credits-burned","href":"/api/analytics/credits-burned"}]}]},{"group":"Code Examples","pages":[{"title":"Python","href":"/examples/python"},{"title":"Node.js","href":"/examples/nodejs"},{"title":"Go","href":"/examples/go"},{"title":"curl","href":"/examples/curl"},{"group":"Advanced","pages":[{"title":"Advanced: Multi-Geo Monitoring in Go","href":"/examples/advanced/multi-geo-go"}]}]},{"group":"Troubleshooting","pages":[{"title":"Error Codes \u0026 Fixes","href":"/troubleshooting/error-codes"},{"title":"Connection Debugging","href":"/troubleshooting/connection-debugging"},{"title":"CAPTCHA \u0026 Ban Rates","href":"/troubleshooting/captcha-ban-rates"},{"title":"Proxy Speed \u0026 Latency","href":"/troubleshooting/proxy-speed-latency"},{"title":"IP Quality \u0026 Fraud Score","href":"/troubleshooting/ip-quality-fraud-score"},{"title":"Account Bans \u0026 Protection","href":"/troubleshooting/account-bans-protection"},{"title":"FAQ","href":"/troubleshooting/faq"}]}]},"basePath":"","title":"Usage Analytics - SOAX","buildId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","deploymentId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","dynamics":[],"chunks":[]}