Skip to main content
Interania

Production readiness checklist

This article provides a checklist of items for you to verify, to ensure that your cluster is "production ready". The Interana UI checklist outlines verification tasks for the Interana user interface (UI), and the CLI checklist for the CLI.

Prerequisites

Before you begin verifying your cluster for production readiness:

Interana UI checklist

Verify the items in this section using the Interana UI with a standard web browser. Click a link to jump directly to a section:

Cluster access

Complete the tasks in the following table to verify cluster access is production ready.

  Cluster access verification  tasks
unchecked-checkbox-icon.png Access the cluster, and verify the cluster is available at the appropriate login URL.
unchecked-checkbox-icon.png Check the SSL certificate to verify that it is valid in both Chrome and Firefox browsers.
unchecked-checkbox-icon.png Log in to Interana, and verify that other users can log in too.
unchecked-checkbox-icon.png Verify that the following new user sign-up process works:
unchecked-checkbox-icon.png
  • Verify that the company domain is in email_suffixes.
unchecked-checkbox-icon.png
unchecked-checkbox-icon.png
  • If you are using password auth for new user creation, verify that SMTP is set up.
unchecked-checkbox-icon.png Verify that the cluster is accessible from all applicable IP addresses.
unchecked-checkbox-icon.png When opening login to the web, verify that 3rd party auth is enabled and password auth is disabled.
unchecked-checkbox-icon.png Verify that the default root@localhost user is disabled.
unchecked-checkbox-icon.png Verify that you see the desired page when you first log in, if you have set the landing_url parameter.

Explorer

Complete the tasks in the following table to verify that Explorer functionality is production ready.

  Explorer verification tasks
unchecked-checkbox-icon.png Verify that an unsampled query runs and returns 100% of the data (checking data tier health).
unchecked-checkbox-icon.png Verify that a query that groups by string columns runs successfully (checking string tier health).
unchecked-checkbox-icon.png Verify that a query grouped by __day__ runs successfully (checking derived column health).
unchecked-checkbox-icon.png Verify that the cluster is configured for the desired time zone.
unchecked-checkbox-icon.png Verify that the cluster default dataset is working properly.
unchecked-checkbox-icon.png Verify that the time scrubber looks as it should, and adjust if necessary.
unchecked-checkbox-icon.png Review the data shape and compare to 1 week previous. Verify that the data makes sense (checking import health).

Dashboards

Complete the tasks in the following table to verify that Dashboard functionality is production ready.

  Dashboard verification tasks 
unchecked-checkbox-icon.png Review key dashboards and verify that all charts load successfully.
unchecked-checkbox-icon.png Inspect chart freshness on key dashboards to ensure they have been refreshed recently (checking precacher health).
unchecked-checkbox-icon.png If SMTP is configured, verify that you can successfully send a dashboard email report.

Named Expressions

Complete the tasks in the following table to verify that Named Expressions functionality is production ready.

  Named Expressions verification tasks
unchecked-checkbox-icon.png Verify that saved cohorts, metrics, and sessions appear in their respective panes.
unchecked-checkbox-icon.png Verify that a functioning funnel returns results. Use a funnel that you know returns results.

CLI checklist

Verify the items in this section with the command line (CLI). Click a link to jump directly to a section:

Import tier

Complete the tasks in the following table to verify that the Import tier is production ready.

  Import tier verification tasks
unchecked-checkbox-icon.png Verify that all import processes are running with iactl status.
unchecked-checkbox-icon.png Verify all desired import jobs are running with: ia job list -s

unchecked-checkbox-icon.png

unchecked-checkbox-icon.png

Look for recent 'Porgress: 100%' messages in: /var/log/inerana/import-pipeline.log

Optionally, check at a per-job level with grep J{jobid}

unchecked-checkbox-icon.png Look for the following errors in /var/log/interana/import-pipeline.log:

unchecked-checkbox-icon.png

  • Data tier overloaded errors—To fix an overloaded tier, you may need to resize the cluster.

unchecked-checkbox-icon.png

  • String tier overloaded errors—To fix an overloaded tier, you may need to resize the cluster.

unchecked-checkbox-icon.png

  • Generators errors

unchecked-checkbox-icon.png

  • Conversion errors

Data tier

Complete the tasks in the following table to verify that the Data tier is production ready.

  Data tier verification tasks
unchecked-checkbox-icon.png Verify that all data processes are running with iactl status.
unchecked-checkbox-icon.png Verify data paths with: ps aux | grep queryserver

unchecked-checkbox-icon.png

  • Also inspect: --primary_data_tier_path
unchecked-checkbox-icon.png Verify that there is plenty of free disk space on the data path with: df -h

unchecked-checkbox-icon.png

Check for whales with du -hs {primary_data_tier_path}/datasets/f/1/tableid/* or with with whale detection script, as described in Balancing data for effective sampling.
unchecked-checkbox-icon.png If you suspect data tier trouble, check: /var/log/interana/query-server.log

String tier

Complete the tasks in the following table to verify that the String tier is production ready.

  String tier verification tasks
unchecked-checkbox-icon.png Verify that all string processes are running with iactl status.
unchecked-checkbox-icon.png Verify string data paths with: ps aux | grep stringserver

unchecked-checkbox-icon.png

  • Also inspect: --storage_path

unchecked-checkbox-icon.png

Verify that there is plenty of free disk space on the string path with: df -h

NOTE: Try to maintain a threshold of < 85% used space.

unchecked-checkbox-icon.png

Check for heavy string columns with: sudo /usr/share/python/interana-python/bin/python /opt/interana/backend/common/py/cardinality_monitor.pyc --runonce
unchecked-checkbox-icon.png If you restart string-server-leaf, check /var/log/interana/string-server-leaf.log for synchronization information.

Config node

Complete the tasks in the following table to verify that the Config node is production ready.

  Config node verification tasks
unchecked-checkbox-icon.png Verify that all config ia processes are running with iactl status.
unchecked-checkbox-icon.png Verify that MYSQL is running with: ps aux | grep mysql

unchecked-checkbox-icon.png

Check /var/log/interana/precacher.log to verify that the precacher is running as it should.

Look for chart_refreshed messages.

unchecked-checkbox-icon.png Check /var/log/interana/schedule-server.log to verify the status of email reports.

API tier

Complete the tasks in the following table to verify that the API tier is production ready.

  API tier verification tasks
unchecked-checkbox-icon.png Verify that all API server processes are running with iactl status.
unchecked-checkbox-icon.png Verify NGINX status with: sudo service nginx status
unchecked-checkbox-icon.png Check /var/log/interana/query-api-server.log for information on running queries.
0votes
4updates
9views

 

 

  • Was this article helpful?