Grok 1.3 Installation Guide This installation guide applies to both Grok Free Edition and Grok Standard Edition products. System Requirements Grok AMI is available in the AWS Marketplace and installation requires a dedicated AWS EC2 instance (m1.medium or larger). The number of instances (or custom metrics) that can be monitored depends on the Grok Edition in use and the size of the underlying EC2 Instance. o Grok Free Edition: Up to 10 instances or custom metrics o Grok Standard Edition: 30-200 instances or custom metrics, depending on the size of the EC2 Server running Grok per the table below min Summary Standard Medium (m1.medium) 30 Standard Large (m1.large) 60 Standard XL (m1.xlarge) 115 M3 Extra Large (m3.xlarge) 115 M3 Double Extra Large (m3.2xlarge) 200 for and metrics at this time. Platforms Supported: o Smartphone: Google Android 4.0.3 and higher (Ice Cream Sandwich and Jelly Bean). Support for IOS and Web clients is currently not available but is under evaluation. o Desktop Web Browser: Google Chrome, IE 9.0+, Safari 6.0+, Firefox 23.0+. Grok supports a 5 monitoring frequency Cloudwatch custom Server Installation Once the Grok Instance is launched, go to the URL of the machine (refer to Note on URL, below) in a web browser to configure Instances for Monitoring. Step 1: Get started and View/Accept Terms Max Instances (or Custom Metrics) Step 2: Enter your AWS credentials Although you can simply provide Grok your regular AWS credentials, we strongly recommend creating a separate set of read only credentials using the AWS IAM capability. For details, please see: http://bit.ly/1kjw5ah Grok 1.3 Installation Page 1
Step 3: Register with Grok This step allows you to register your product with Grok. We will not SPAM you or sell your email. We may send you new product information and the option to try Beta features. Registration is optional. Grok 1.3 Installation Page 2
Step 4: Select Instances or Custom Metrics to Monitor The following methods are available to add Instances for Monitoring by Grok. You can use one or more methods to select Instances Method A Select Automatically Method B Select Manually Method C Import Previous Selections Method D Select Autostacks The current and latest selection of Instances is displayed on the right. For details and examples of adding Custom Metrics, please refer to the Custom Metrics Guide. Please note that Grok supports monitoring of AWS Auto Scaling Groups (ASG). AWS ASG s can be added to Grok similar to an AWS Instance using Methods A-C. Grok 1.3 Installation Page 3
Step 4A). Select Automatically Instances can be selected automatically using AWS Region filters and an additional selection of AWS Name Tags. Step 4B). Select Manually Step 4C). Import Previous Selections Any previously saved list of Instances and Metrics can be also be exported and saved, to be brought back at a later time, in Step 4c). Grok 1.3 Installation Page 4
Step 4D). Select Autostacks Grok has created a new construct called an Autostack for monitoring a dynamic group of logically related EC2 Servers. Autostacks are monitored as a group and viewed as a single "Instance" within Grok. The only requirements are for Instances or ASG s within an Autostack to be logically doing the same thing, located in the same region and be previously tagged with the same AWS Tag. Autostacks can be created and members selected in 4b). You must give the Autostack a unique name. Once you click on Find Members, you can review members of the Autostack and then create the Autostack. Please note that once created, we do not allow editing the names, region or Tag filters of an Autostack. Should there be a need for change, we recommend creating a new Autostack. Selecting Metrics Select the the region, individual metrics that you d like to measure by expanding namespace/dimension and then click on an instance or Autostack. This will cause a pop-up Grok 1.3 Installation Page 5
menu to appear with the metrics available for that instance or Autostack. Some metrics are chosen by default and you can change these selections. Repeat for each of the instances and metrics you d like to monitor. Don t worry, you can always come back and add more later. Grok will remember each selection as you click through the page. For Autostacks, in addition to Metric details, you will be able to view details of the Autostack itself including AWS Region, Function and Members. Grok s Cortical Learning Algorithm (CLA) will begin building models of the Selected Instances immediately. The Instance will stay in Training while the model is still in the Learning-only phase. The state will move to Active when the Instance is actively being monitored. Step 5: Notification Settings The next step involves setting up an Email and AWS Region which will be used to send email via Amazon's push messaging service Simple Email Service (Amazon SES). Should you want email notifications sent to you by Grok this step is required in conjunction with enabling Email Notification on the mobile client. Please note that additional charges may apply for Amazon SES (http://aws.amazon.com/ses/) Grok 1.3 Installation Page 6
Server Setup Complete The Grok Server Setup is now complete. Please use the URL shown to access the Grok server. NOTE ON URL Grok recommends setting up a Route53 entry for the server to give it a friendly URL. 1. Copy the EC2 public DNS name of the instance you want to create a human-useful pointer for. 2. Go to the Route53 page 3. Double-click the domain you d like to use in the list of hosted zones (e.g.: groksolutions.com). You should now see a list of DNS entries for the domain. 4. Search for the name you're going to add to ensure no one else has already used it. 5. Click the "Create Record Set" button 6. Add a CNAME record (e.g.: grokbeta.groksolutions.com), and set it to point to the public DNS name you got in step 1 7. Set the TTL to 60 seconds 8. Save. You should be able to reference the new DNS name almost immediately. Grok 1.3 Installation Page 7
Mobile App Installation The next step is to install and setup the Grok Android Application on a Mobile Phone. The Server URL and password shown in the screen below will need to be entered into the Mobile Application. On the Android Phone: 1. Install Grok app via the Play store: a. https://play.google.com/store/apps/details?id=com.groksolutions.grok.mobile b. Click the install button c. Select your mobile device and click Install d. Click the OK button. Grok will now be automatically installed to your mobile device Or, Search for Grok in the Play store to install from your device! 2. Configure the Grok app Enter the server details from your instance and password provided at the end of the server installation process. 3. Start using the Grok app! NOTE The first time you load the app, it will take a few minutes to download all of the data. For details on using the app including reading the charts, please see the Grok User Guide. Grok 1.3 Installation Page 8
Maintaining and Editing Grok Server Settings The previous steps can be re-visited to view, edit or change anytime from a drop down list on the top right under Setup Over time, you may want to add additional metrics to monitor. That s as simple as repeating Step 2: Enter your AWS credentials Although you can simply provide Grok your regular AWS credentials, we strongly recommend creating a separate set of read only credentials using the AWS IAM capability. For details, please see: http://bit.ly/1kjw5ah Step 3: Register with Grok This step allows you to register your product with Grok. We will not SPAM you or sell your email. We may send you new product information and the option to try Beta features. Registration is optional. Grok 1.3 Installation Page 9
Grok 1.3 Installation Page 10
Step 4: Select Instances or Custom Metrics to Monitor The following methods are available to add Instances for Monitoring by Grok. You can use one or more methods to select Instances Method A Select Automatically Method B Select Manually Method C Import Previous Selections Method D Select Autostacks The current and latest selection of Instances is displayed on the right. For details and examples of adding Custom Metrics, please refer to the Custom Metrics Guide. Please note that Grok supports monitoring of AWS Auto Scaling Groups (ASG). AWS ASG s can be added to Grok similar to an AWS Instance using Methods A-C. Grok 1.3 Installation Page 11
Step 4A). Select Automatically Instances can be selected automatically using AWS Region filters and an additional selection of AWS Name Tags. Step 4B). Select Manually. You can easily get back there by using your web browser to go to your instance (https://<public_dns>). You ll then have the option to Select New Instances to Monitor: To remove metrics, you ll just need to browse to your instance (as above) and use the select boxes to choose which instances you d like to delete from monitoring, then hit the Delete button. NOTE If one of the instances ends up in an Error status, you can simply delete the instance and re-add it. Updating the Grok Server When updates to the Grok Server are available, they will automatically appear as an option on the top of the screen. Grok 1.3 Installation Page 12