{"_id":"574e8b3d491084190033739b","user":"56a1f82b06150b0d002ad173","__v":21,"parentDoc":null,"category":{"_id":"5721f4e9dcfa860e005bef98","project":"56a1f77442dfda0d00046285","__v":0,"version":"56a1f77542dfda0d00046288","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-04-28T11:32:57.879Z","from_sync":false,"order":5,"slug":"partners-integrations","title":"Partners & Integrations"},"project":"56a1f77442dfda0d00046285","version":{"_id":"56a1f77542dfda0d00046288","__v":9,"project":"56a1f77442dfda0d00046285","createdAt":"2016-01-22T09:33:41.397Z","releaseDate":"2016-01-22T09:33:41.397Z","categories":["56a1f77542dfda0d00046289","56a1fdf442dfda0d00046294","56a2079f0067c00d00a2f955","56a20bdf8b2e6f0d0018ea84","56a3e78a94ec0a0d00b39fed","56af19929d32e30d0006d2ce","5721f4e9dcfa860e005bef98","574e870be892bf0e004fde0d","5832fdcdb32d820f0072e12f"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-01T07:14:05.777Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"Trace provides error detection, alerting, distributed tracing and process monitoring for your Clever Cloud applications. Install the Trace Trace Clever Cloud add-on by following these steps:\n\n## 1.  Ensure that all prerequisites are met\n\n- Have npm version 2.7.0 or greater installed. To update simply use `npm install npm -g`\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Be sure to use npm version greater than 2.7.0. - as Trace uses scoped packages. If you can't update to npm:::at:::2.7.0 for whatever reason, you can still install Trace using `npm i risingstack/trace-nodejs\",\n  \"title\": \"npm version\"\n}\n[/block]\n## 2. Install the Clever Cloud addon\n\n- 2.1. Click the \"Add an add-on\" button on the Clever Cloud dashboard\n- 2.2. Select the \"Trace by RisingStack\" add-on \n- 2.3. Choose a plan that fits for your application\n- 2.4. Select the applications that will use this add-on. Linking more applications with the same add-on helps to find issues in a distributed system (microservices or SOA architecture)\n\nThe add-on sets the `TRACE_API_KEY ` environment variable for every linked application.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Link multiple applications\",\n  \"body\": \"With linking multiple applications to the same add-on you will be able to monitor and debug distributed systems and see how you applications communicate with each other. This is recommended for micro-services and SOA architectures.\"\n}\n[/block]\n## 3. Name your application\n\nTo start monitoring your applications you must first add them and name them by setting up `TRACE_SERVICE_NAME` environment variables for them.\n\nTo add the environment variable follow these steps:\n\n- 1. Select your application\n- 2. Pick the \"Environment variables\" menu\n- 3. Add a new variable with, Name: `TRACE_SERVICE_NAME `, Value: `My Application 1` \n- 4. Click \"Add\"\n- 5. Repeat for all linked applications\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/xzvh5uYATK2Nc5858Zco_environment-variables-in-clever-cloud-trace-addon.png\",\n        \"environment-variables-in-clever-cloud-trace-addon.png\",\n        \"788\",\n        \"265\",\n        \"#b54b53\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nIf you'd like to know more on how you should  name your services, read the [guideline on naming infrastructures and services](http://trace-docs.risingstack.com/docs/how-to-name-your-infrastructure-and-services).\n\n## 4. Install the Trace collector agent\n\n- 4.1. Install the Trace collector as a dependency of your Node.js application using the following command `npm install @risingstack/trace --save`\n\n- 4.2 Import Trace in the main script of your application. It should be the **first** module you require.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"// index.js\\n\\nrequire([email protected]/trace') // trace should be on top\\n\\n// your application code\\n\\nvar express = require('express') \\nvar app = express()\\n\\n// so on ...\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\n- 4.3 Deploy your application!\n- 4.4 Generate some traffic on your website.\n\n## Enjoy your installed Trace add-on!\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Don't see your data?\",\n  \"body\": \"1. I just integrated my service and installed Trace: Run your application and wait a few minutes.\\n2. I integrated my service more than 5 minutes ago: Check out the [Troubleshooting page](https://trace-docs.risingstack.com/docs/troubleshooting).\\n3. I don’t know: Contact us via the live chat and we’ll figure it out for you.\"\n}\n[/block]\n## How to link Trace with additional applications?\n\n- 1. Select your application\n- 2. Pick the \"Add-ons\" menu\n- 3. Click the \"link\" button in the list where you see your Trace add-on\n- 4. Repeat the original integration steps from # 3 Name you application","excerpt":"Use Trace via the Clever Cloud add-on","slug":"clever-cloud","type":"basic","title":"Clever Cloud"}

Clever Cloud

Use Trace via the Clever Cloud add-on

Trace provides error detection, alerting, distributed tracing and process monitoring for your Clever Cloud applications. Install the Trace Trace Clever Cloud add-on by following these steps: ## 1. Ensure that all prerequisites are met - Have npm version 2.7.0 or greater installed. To update simply use `npm install npm -g` [block:callout] { "type": "warning", "body": "Be sure to use npm version greater than 2.7.0. - as Trace uses scoped packages. If you can't update to [email protected] for whatever reason, you can still install Trace using `npm i risingstack/trace-nodejs", "title": "npm version" } [/block] ## 2. Install the Clever Cloud addon - 2.1. Click the "Add an add-on" button on the Clever Cloud dashboard - 2.2. Select the "Trace by RisingStack" add-on - 2.3. Choose a plan that fits for your application - 2.4. Select the applications that will use this add-on. Linking more applications with the same add-on helps to find issues in a distributed system (microservices or SOA architecture) The add-on sets the `TRACE_API_KEY ` environment variable for every linked application. [block:callout] { "type": "success", "title": "Link multiple applications", "body": "With linking multiple applications to the same add-on you will be able to monitor and debug distributed systems and see how you applications communicate with each other. This is recommended for micro-services and SOA architectures." } [/block] ## 3. Name your application To start monitoring your applications you must first add them and name them by setting up `TRACE_SERVICE_NAME` environment variables for them. To add the environment variable follow these steps: - 1. Select your application - 2. Pick the "Environment variables" menu - 3. Add a new variable with, Name: `TRACE_SERVICE_NAME `, Value: `My Application 1` - 4. Click "Add" - 5. Repeat for all linked applications [block:image] { "images": [ { "image": [ "https://files.readme.io/xzvh5uYATK2Nc5858Zco_environment-variables-in-clever-cloud-trace-addon.png", "environment-variables-in-clever-cloud-trace-addon.png", "788", "265", "#b54b53", "" ] } ] } [/block] If you'd like to know more on how you should name your services, read the [guideline on naming infrastructures and services](http://trace-docs.risingstack.com/docs/how-to-name-your-infrastructure-and-services). ## 4. Install the Trace collector agent - 4.1. Install the Trace collector as a dependency of your Node.js application using the following command `npm install @risingstack/trace --save` - 4.2 Import Trace in the main script of your application. It should be the **first** module you require. [block:code] { "codes": [ { "code": "// index.js\n\nrequire([email protected]/trace') // trace should be on top\n\n// your application code\n\nvar express = require('express') \nvar app = express()\n\n// so on ...", "language": "text" } ] } [/block] - 4.3 Deploy your application! - 4.4 Generate some traffic on your website. ## Enjoy your installed Trace add-on! [block:callout] { "type": "danger", "title": "Don't see your data?", "body": "1. I just integrated my service and installed Trace: Run your application and wait a few minutes.\n2. I integrated my service more than 5 minutes ago: Check out the [Troubleshooting page](https://trace-docs.risingstack.com/docs/troubleshooting).\n3. I don’t know: Contact us via the live chat and we’ll figure it out for you." } [/block] ## How to link Trace with additional applications? - 1. Select your application - 2. Pick the "Add-ons" menu - 3. Click the "link" button in the list where you see your Trace add-on - 4. Repeat the original integration steps from # 3 Name you application