Quick Start Guide

Welcome to DataPulse Analytics. This guide will walk you through setting up your workspace, connecting your data sources, building your first dashboard, and automating insights. You'll be up and running in under 30 minutes.

25 min read Last updated: Jan 2025 v2.4.1
1

Workspace Setup

Begin by creating your analytics workspace and configuring your organization profile. This establishes the foundation for all data projects, team collaboration, and security policies.

  1. Navigate to Settings > Workspaces and click Create New Workspace
  2. Enter your organization name and select your primary industry vertical
  3. Configure default timezones, currency formats, and data retention policies
  4. Enable two-factor authentication for all admin accounts
Pro Tip Use environment prefixes (e.g., dev-, staging-, prod-) to keep workspaces organized across your development lifecycle.
Configuration YAML
workspace:
  name: "Acme Analytics Prod"
  region: "us-east-1"
  data_retention: 365 # days
  encryption: "AES-256"
  compliance:
    - "SOC2"
    - "GDPR"
    - "HIPAA"
2

Data Connection

Connect your existing databases, SaaS platforms, and API endpoints. DataPulse supports over 120 native connectors with automatic schema mapping and incremental sync capabilities.

Connector Auth Method Sync Frequency Status
PostgreSQLSSL/TLS + SSHReal-time / 5min● Active
SnowflakeOAuth 2.015min / Hourly● Active
SalesforceAPI Key + SecretDaily / Real-time● Active
Google Analytics 4Service AccountHourly● Pending
Security Notice Never commit API secrets directly to version control. Use environment variables or our built-in Secret Manager for all credentials.
Python SDK
from datapulse import Client

# Initialize with API key from environment
c = Client(api_key=os.environ["DP_API_KEY"])

# Connect to PostgreSQL
connector = c.connectors.create(
    type="postgresql",
    host="db.example.com",
    port=5432,
    database="analytics_prod",
    ssl=True
)
connector.sync_schema()
3

First Dashboard

Transform connected data into interactive visualizations. Use our drag-and-drop builder or SQL composer to create KPIs, trend lines, cohort analyses, and geographic heatmaps.

Steps to build your first executive dashboard:

  • Go to Dashboards > Create New
  • Select your recently synced dataset as the source
  • Add widgets: Revenue Trend (Line), Conversion Rate (Gauge), Regional Performance (Map)
  • Apply filters for date ranges, segments, and custom dimensions
  • Click Publish and share via link or embed token
Best Practice Start with 3-5 core metrics that directly tie to business objectives. Avoid dashboard clutter by hiding low-impact widgets in advanced views.
4

Alerts & Automation

Set up proactive monitoring to catch anomalies, track milestone achievements, and trigger automated workflows without manual intervention.

Alert Configuration
alert:
  name: "Revenue Drop Detection"
  condition: "revenue_usd < previous_day * 0.85"
  threshold: 2 # consecutive periods
  notify:
    - "slack#analytics-team"
    - "email:ops@company.com"
  action:
    type: "create_jira_ticket"
    priority: "high"

Alerts support Slack, Teams, PagerDuty, webhooks, and email. You can also trigger custom automation scripts via our Event Bus API.

5

Team Management

Invite stakeholders and assign role-based permissions. DataPulse follows a strict RBAC model to ensure data governance and audit compliance.

RoleAccess LevelCapabilities
AdminFullWorkspace config, user mgmt, billing, audit logs
AnalystRead/WriteCreate dashboards, run queries, export data
ViewerRead-OnlyView published dashboards, comment, share
EngineerTechnicalManage connectors, run pipelines, access raw logs

Use SCIM provisioning for enterprise SSO integration with Okta, Azure AD, or Ping Identity.

Troubleshooting

Common issues and resolutions:

  • Connection Timeout: Verify firewall rules allow outbound traffic to ports 443/5432. Check VPC peering if using private endpoints.
  • Schema Sync Failed: Ensure your database grants SELECT permissions on the information_schema. Run connector.validate() to debug.
  • Dashboard Loading Slowly: Enable query caching, add materialized views for heavy aggregations, or filter date ranges to reduce scan volume.
  • Alert Not Firing: Verify time window alignment, check evaluation frequency in Settings > Scheduling, and review the Alert Logs tab.
Still stuck? Run dp-cli diagnose from your terminal to generate a system health report. Share the output ID with our support team for faster resolution.

Support & Contact

Our solutions engineers are available to help you scale your analytics infrastructure:

  • Documentation: docs.datapulse.io
  • Community Slack: Join #datapulse-users for peer support
  • Enterprise Support: support@datapulse.io (24/7 SLA)
  • Professional Services: Schedule a workshop or custom implementation plan
"}