Skip to content

Commit

Permalink
Deployed 4c4f31d with MkDocs version: 1.6.0
Browse files Browse the repository at this point in the history
  • Loading branch information
agardnerIT committed Sep 10, 2024
1 parent 82d290e commit 7b99deb
Show file tree
Hide file tree
Showing 2 changed files with 1 addition and 2 deletions.
1 change: 0 additions & 1 deletion run-demo/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -569,7 +569,6 @@ <h2 id="view-events">View Events<a class="headerlink" href="#view-events" title=
| filter event.category == &quot;finished&quot;
</code></pre>
<p><img alt="sdlc event" src="../images/sdlc-event.png" /></p>
<p>User exercise: Modify the JSON body to also send the number of Virtual Users (VUs) used to Dynatrace. Re-run the load test to see the new event.</p>
<p>The demo is complete.</p>
<div class="grid cards">
<ul>
Expand Down
2 changes: 1 addition & 1 deletion search/search_index.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"1. About","text":"<p>This demo will run an Apache JMeter script and send a Dynatrace SDLC event when the load test is finished.</p> <p>This event can be used to trigger further automations such as Dynatrace workflows.</p> <p></p>"},{"location":"#compatibility","title":"Compatibility","text":"Deployment Tutorial Compatible Dynatrace Managed \u2714\ufe0f Dynatrace SaaS \u2714\ufe0f <ul> <li>Click Here to Begin </li> </ul>"},{"location":"cleanup/","title":"4. Cleanup","text":"<p>To cleanup resources, go to https://github.com/codespaces and delete the codespace.</p> <p>You may also want to deactivate or delete the API token.</p> <ul> <li>What's Next? </li> </ul>"},{"location":"getting-started/","title":"2. Getting Started","text":""},{"location":"getting-started/#gather-details-tenant-id","title":"Gather Details: Tenant ID","text":"<p>You will need access to a Dynatrace tenant. If you do not have access, sign up for a free 15 day trial.</p> <p>Make a note of your Dynatrace tenant ID. It is the first bit of your URL (eg. <code>abc12345</code> in the following examples):</p> <pre><code>https://abc12345.live.dynatrace.com\nhttps://abc12345.apps.dynatrace.com\n</code></pre> <p>Reformat the URL like this: <code>https://TENANT_ID.live.dynatrace.com</code> eg. <code>https://abc12345.live.dynatrace.com</code></p>"},{"location":"getting-started/#gather-details-create-api-token","title":"Gather Details: Create API Token","text":"<p>Create an API token with the following permissions:</p> <ul> <li><code>ReadConfig</code></li> <li><code>DataExport</code></li> <li><code>CaptureRequestData</code></li> <li><code>openpipeline.events_sdlc</code></li> </ul> <p>The <code>ReadConfig</code>, <code>DataExport</code> and <code>CaptureRequestData</code> permissions will be used by the Monaco Configuration as Code utility to apply configuration to your Dynatrace environment. This configuration will capture the <code>x-dynatrace-test</code> HTTP header and process the values described here.</p> <p>The <code>openpipeline.events_sdlc</code> permission is required to send the \"load test finished\" SDLC event to Dynatrace.</p>"},{"location":"getting-started/#start-demo","title":"Start Demo","text":"<p>Click this button to launch the demo in a new tab.</p> <p></p> <ul> <li>Click Here to Run the Demo </li> </ul>"},{"location":"resources/","title":"6. Resources","text":""},{"location":"resources/#resources","title":"Resources","text":"<ul> <li>Sign up for a Dynatrace Trial</li> <li>Dynatrace &amp; JMeter Integration Documentation</li> <li>This tutorial on GitHub</li> </ul>"},{"location":"run-demo/","title":"3. Run Demo","text":""},{"location":"run-demo/#x-dynatrace-test-headers","title":"x-dynatrace-test Headers","text":"<p>Open jmeterscripts/example.jmx and notice a few things:</p> <ul> <li>The load test calls <code>example.com</code> and specifies an <code>x-dynatrace-test</code> headers with these values:</li> </ul> <pre><code>SI=jmeter;LSN=Scenario1;TSN=Step1;LTN=Demo LoadTest 1\n</code></pre> <p>These values help arrange and organize your load testing across multiple scenarios, steps and load test names.</p> <p>The definition of these values (and additional values) can be found here.</p>"},{"location":"run-demo/#tear-down-thread-group","title":"Tear Down Thread Group","text":"<p>A <code>tearDown</code> thread group exists (which fires at the end of the load test)</p> <ul> <li>This request is a <code>POST</code> to <code>/platform/ingest/v1/events.sdlc</code> with a JSON payload</li> <li>The request has header values set for <code>Content-Type</code> and <code>Authorization</code></li> </ul> <p>This event allows integration opportunitities into other Dynatrace functionality such as triggering workflows automatically at the end of a load test.</p>"},{"location":"run-demo/#run-jmeter","title":"Run JMeter","text":"<p>In the codespace terminal, paste the following:</p> <pre><code>apache-jmeter/bin/jmeter.sh -n -t jmeterscripts/example.jmx\n</code></pre>"},{"location":"run-demo/#view-events","title":"View Events","text":"<p>When the load test finished, the teardown thread group sends a Software Delivery Lifecycle Event (SDLC) to Dynatrace.</p> <p></p> <p>Notice that the event contains metadata such as the <code>provider</code> and <code>service</code> which can be used for filtering in Dynatrace (see DQL below).</p> <p>This event can be used as a trigger Dynatrace for workflows, synthetic tests, the site reliability guardian and more.</p> <p>In Dynatrace:</p> <ul> <li>Press <code>ctrl + k</code> and search for <code>notebooks</code></li> <li>Open an existing notebook or create a new one</li> <li>Add a new <code>DQL</code> section and paste the following</li> </ul> <pre><code>fetch events\n| filter event.kind == \"SDLC_EVENT\"\n| filter event.provider == \"jmeter\"\n| filter event.category == \"finished\"\n</code></pre> <p></p> <p>User exercise: Modify the JSON body to also send the number of Virtual Users (VUs) used to Dynatrace. Re-run the load test to see the new event.</p> <p>The demo is complete.</p> <ul> <li>Click Here to Delete and Cleanup resources </li> </ul>"},{"location":"whats-next/","title":"5. What's Next?","text":"<p>The official Dynatrace documentation has more information that you will probably find useful..</p> <p>View the resources page for more links and useful materials.</p> <ul> <li>View Resources </li> </ul>"}]}
{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"1. About","text":"<p>This demo will run an Apache JMeter script and send a Dynatrace SDLC event when the load test is finished.</p> <p>This event can be used to trigger further automations such as Dynatrace workflows.</p> <p></p>"},{"location":"#compatibility","title":"Compatibility","text":"Deployment Tutorial Compatible Dynatrace Managed \u2714\ufe0f Dynatrace SaaS \u2714\ufe0f <ul> <li>Click Here to Begin </li> </ul>"},{"location":"cleanup/","title":"4. Cleanup","text":"<p>To cleanup resources, go to https://github.com/codespaces and delete the codespace.</p> <p>You may also want to deactivate or delete the API token.</p> <ul> <li>What's Next? </li> </ul>"},{"location":"getting-started/","title":"2. Getting Started","text":""},{"location":"getting-started/#gather-details-tenant-id","title":"Gather Details: Tenant ID","text":"<p>You will need access to a Dynatrace tenant. If you do not have access, sign up for a free 15 day trial.</p> <p>Make a note of your Dynatrace tenant ID. It is the first bit of your URL (eg. <code>abc12345</code> in the following examples):</p> <pre><code>https://abc12345.live.dynatrace.com\nhttps://abc12345.apps.dynatrace.com\n</code></pre> <p>Reformat the URL like this: <code>https://TENANT_ID.live.dynatrace.com</code> eg. <code>https://abc12345.live.dynatrace.com</code></p>"},{"location":"getting-started/#gather-details-create-api-token","title":"Gather Details: Create API Token","text":"<p>Create an API token with the following permissions:</p> <ul> <li><code>ReadConfig</code></li> <li><code>DataExport</code></li> <li><code>CaptureRequestData</code></li> <li><code>openpipeline.events_sdlc</code></li> </ul> <p>The <code>ReadConfig</code>, <code>DataExport</code> and <code>CaptureRequestData</code> permissions will be used by the Monaco Configuration as Code utility to apply configuration to your Dynatrace environment. This configuration will capture the <code>x-dynatrace-test</code> HTTP header and process the values described here.</p> <p>The <code>openpipeline.events_sdlc</code> permission is required to send the \"load test finished\" SDLC event to Dynatrace.</p>"},{"location":"getting-started/#start-demo","title":"Start Demo","text":"<p>Click this button to launch the demo in a new tab.</p> <p></p> <ul> <li>Click Here to Run the Demo </li> </ul>"},{"location":"resources/","title":"6. Resources","text":""},{"location":"resources/#resources","title":"Resources","text":"<ul> <li>Sign up for a Dynatrace Trial</li> <li>Dynatrace &amp; JMeter Integration Documentation</li> <li>This tutorial on GitHub</li> </ul>"},{"location":"run-demo/","title":"3. Run Demo","text":""},{"location":"run-demo/#x-dynatrace-test-headers","title":"x-dynatrace-test Headers","text":"<p>Open jmeterscripts/example.jmx and notice a few things:</p> <ul> <li>The load test calls <code>example.com</code> and specifies an <code>x-dynatrace-test</code> headers with these values:</li> </ul> <pre><code>SI=jmeter;LSN=Scenario1;TSN=Step1;LTN=Demo LoadTest 1\n</code></pre> <p>These values help arrange and organize your load testing across multiple scenarios, steps and load test names.</p> <p>The definition of these values (and additional values) can be found here.</p>"},{"location":"run-demo/#tear-down-thread-group","title":"Tear Down Thread Group","text":"<p>A <code>tearDown</code> thread group exists (which fires at the end of the load test)</p> <ul> <li>This request is a <code>POST</code> to <code>/platform/ingest/v1/events.sdlc</code> with a JSON payload</li> <li>The request has header values set for <code>Content-Type</code> and <code>Authorization</code></li> </ul> <p>This event allows integration opportunitities into other Dynatrace functionality such as triggering workflows automatically at the end of a load test.</p>"},{"location":"run-demo/#run-jmeter","title":"Run JMeter","text":"<p>In the codespace terminal, paste the following:</p> <pre><code>apache-jmeter/bin/jmeter.sh -n -t jmeterscripts/example.jmx\n</code></pre>"},{"location":"run-demo/#view-events","title":"View Events","text":"<p>When the load test finished, the teardown thread group sends a Software Delivery Lifecycle Event (SDLC) to Dynatrace.</p> <p></p> <p>Notice that the event contains metadata such as the <code>provider</code> and <code>service</code> which can be used for filtering in Dynatrace (see DQL below).</p> <p>This event can be used as a trigger Dynatrace for workflows, synthetic tests, the site reliability guardian and more.</p> <p>In Dynatrace:</p> <ul> <li>Press <code>ctrl + k</code> and search for <code>notebooks</code></li> <li>Open an existing notebook or create a new one</li> <li>Add a new <code>DQL</code> section and paste the following</li> </ul> <pre><code>fetch events\n| filter event.kind == \"SDLC_EVENT\"\n| filter event.provider == \"jmeter\"\n| filter event.category == \"finished\"\n</code></pre> <p></p> <p>The demo is complete.</p> <ul> <li>Click Here to Delete and Cleanup resources </li> </ul>"},{"location":"whats-next/","title":"5. What's Next?","text":"<p>The official Dynatrace documentation has more information that you will probably find useful..</p> <p>View the resources page for more links and useful materials.</p> <ul> <li>View Resources </li> </ul>"}]}

0 comments on commit 7b99deb

Please sign in to comment.