Grok Installation Guide
Grok Release 1.0 – 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 numbers of instances (or custom metrics) that can be monitored depend 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
Summary Standard Medium (m1.medium) Standard Large (m1.large) Standard XL (m1.xlarge) M3 Extra Large (m3.xlarge) M3 Double Extra Large (m3.2xlarge)
• •
Max Instances (or Custom Metrics) 30 60 115 115 200
Grok supports a 5 min monitoring frequency for Cloudwatch and custom metrics at this time. Platforms Supported: o Smartphone: Google Android 4.0.3 and higher (Ice Cream Sandwich and Jelly Bean). o Desktop Web Browser: Google Chrome, Internet Explorer 9.0 or higher, Safari 6.0 or higher, Firefox 23.0 or higher.
Server Side Installation
Once the Grok Instance is launched, go to the URL of the machine (refer to Note below) in a web browser to configure Instances for Monitoring. Step 1: Get started and View/Accept Terms
Grok Installation (Release 1.0) Updated: January 28, 2014
Page 1 Email: [email protected]
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: https://groksolutions.com/static/pdf/support/aws/generate-restrictive-credentials.pdf Step 3: Select Instances or Custom Metrics to Monitor The following methods are available to add Instances for Monitoring by Grok – Method 1 – Automatic Selection (Coming Soon) Method 2 – Manual Selection of Instances Method 3 – Import Previous Selections The Instance Selections can also be imported from a previously saved file. For details and examples of adding Custom Metrics, please refer to the “Custom Metrics Guide”
Step 3b): Setup the metrics to measure
Grok Installation (Release 1.0) Updated: January 28, 2014
Page 2 Email: [email protected]
Select the metrics that you’d like to measure by expanding the region, namespace/dimension and then click on an individual instance. This will cause a pop-up menu to appear with the metrics available for that instance. 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.
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 3c) :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 3c). Once you have selected all of the Instances and Metrics you’re initially interested in, click “Next”.
NOTE 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 Installation (Release 1.0) Updated: January 28, 2014
Page 3 Email: [email protected]
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!
Grok Installation (Release 1.0) Updated: January 28, 2014
Page 4 Email: [email protected]
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 Installation (Release 1.0) Updated: January 28, 2014
Page 5 Email: [email protected]
Maintaining / Editing Configuration
Over time, you may want to add additional metrics to monitor. That’s as simple as repeating “Setup the Instances to Monitor”. You can easily get back there by using your web browser to go to your instance (https://). 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.
Grok Installation (Release 1.0) Updated: January 28, 2014
Page 6 Email: [email protected]
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 numbers of instances (or custom metrics) that can be monitored depend 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
Summary Standard Medium (m1.medium) Standard Large (m1.large) Standard XL (m1.xlarge) M3 Extra Large (m3.xlarge) M3 Double Extra Large (m3.2xlarge)
• •
Max Instances (or Custom Metrics) 30 60 115 115 200
Grok supports a 5 min monitoring frequency for Cloudwatch and custom metrics at this time. Platforms Supported: o Smartphone: Google Android 4.0.3 and higher (Ice Cream Sandwich and Jelly Bean). o Desktop Web Browser: Google Chrome, Internet Explorer 9.0 or higher, Safari 6.0 or higher, Firefox 23.0 or higher.
Server Side Installation
Once the Grok Instance is launched, go to the URL of the machine (refer to Note below) in a web browser to configure Instances for Monitoring. Step 1: Get started and View/Accept Terms
Grok Installation (Release 1.0) Updated: January 28, 2014
Page 1 Email: [email protected]
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: https://groksolutions.com/static/pdf/support/aws/generate-restrictive-credentials.pdf Step 3: Select Instances or Custom Metrics to Monitor The following methods are available to add Instances for Monitoring by Grok – Method 1 – Automatic Selection (Coming Soon) Method 2 – Manual Selection of Instances Method 3 – Import Previous Selections The Instance Selections can also be imported from a previously saved file. For details and examples of adding Custom Metrics, please refer to the “Custom Metrics Guide”
Step 3b): Setup the metrics to measure
Grok Installation (Release 1.0) Updated: January 28, 2014
Page 2 Email: [email protected]
Select the metrics that you’d like to measure by expanding the region, namespace/dimension and then click on an individual instance. This will cause a pop-up menu to appear with the metrics available for that instance. 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.
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 3c) :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 3c). Once you have selected all of the Instances and Metrics you’re initially interested in, click “Next”.
NOTE 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 Installation (Release 1.0) Updated: January 28, 2014
Page 3 Email: [email protected]
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!
Grok Installation (Release 1.0) Updated: January 28, 2014
Page 4 Email: [email protected]
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 Installation (Release 1.0) Updated: January 28, 2014
Page 5 Email: [email protected]
Maintaining / Editing Configuration
Over time, you may want to add additional metrics to monitor. That’s as simple as repeating “Setup the Instances to Monitor”. You can easily get back there by using your web browser to go to your instance (https://). 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.
Grok Installation (Release 1.0) Updated: January 28, 2014
Page 6 Email: [email protected]
