{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21250,"path":"integrate-applications/integration-hub/gremlin-spoke.md","title":"Gremlin Spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Gremlin Spoke\n\nSimulate outages and manage attacks using Gremlin instance from your ServiceNow instance.\n\n**Important:**\n\nStarting with the Yokohama release, Gremlin Spoke is being prepared for future deprecation. It will be hidden and no longer activated on new instances but will continue to be supported. Spoke Generator provides the latest experience for this functionality.\n\nFor details, see the [Deprecation Process \\[KB0867184\\]](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0867184) article in the Now Support knowledge base.\n\n## Request apps on the Store\n\nVisit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the [ServiceNow Store version history release notes](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html).\n\n## Integration Hub subscription\n\nThis spoke requires an Integration Hub subscription. For more information, see [Legal schedules - IntegrationHub overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf).\n\n## Spoke version\n\nGremlin spoke v1.0.3 is the latest version. For version history of the spoke, see [Gremlin spoke release notes](https://www.servicenow.com/docs/r/store-release-notes/store-integrationhub-rn-gremlin.html).\n\n## Supported versions\n\nThis spoke was built for Gremlin version v1, but may be compatible with later versions.\n\n## Spoke requirements\n\n-   Set up clients as per your requirement.\n-   Admin access to the Gremlin dashboard.\n-   Team in your Gremlin account for integration with ServiceNow instance. For more information about creating teams, see [Teams](https://www.gremlin.com/docs/users-and-teams/teams/).\n-   Team ID and API Key of the team. Copy and record these value for later use. For more information about accessing these values, see the [Signature-based Authentication](https://www.gremlin.com/docs/infrastructure-layer/authentication/) section.\n\n## Spoke dependencies\n\nIf you’re having trouble installing the app, ensure that these dependent plugins are installed:\n\n-   ServiceNow IntegrationHub Runtime \\(com.glide.hub.integration.runtime\\)\n-   Complex Object \\(com.glide.cobject\\)\n-   ServiceNow Flow Designer - Dynamic Inputs \\(com.glide.hub.dynamic\\_inputs\\)\n-   ServiceNow IntegrationHub Action Step - REST \\(com.glide.hub.action\\_step.rest\\)\n\n**Note:** Some of these plugins are licensable features and require appropriate licenses, if used outside the spoke implementation.\n\n## Spoke actions\n\nThe Gremlin spoke provides actions to automate Gremlin tasks when events occurs in your ServiceNow instance. Available actions include:\n\n<table id=\"table_u1p_kh2_hfb\"><thead><tr><th>\n\nCategory\n\n</th><th>\n\nAction\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td rowspan=\"5\">\n\nAttack Management\n\n</td><td>\n\nCreate Attack\n\n</td><td>\n\nCreates an attack on the Gremlin platform.\n\n</td></tr><tr><td>\n\nGet Attack Details\n\n</td><td>\n\nRetrieves details about an attack.\n\n</td></tr><tr><td>\n\nGet Attack Executions\n\n</td><td>\n\nRetrieves a list of executions associated with an attack.\n\n</td></tr><tr><td>\n\nHalt All Attacks\n\n</td><td>\n\nIdempotently halts all active attacks across the Gremlin platform.\n\n</td></tr><tr><td>\n\nLook up Attacks\n\n</td><td>\n\nLists all attacks on the Gremlin platform.**Note:**\n\n-   By default, this action can retrieve data up to 5 MB. You can configure the **glide.pf.rest.response\\_payload\\_max\\_size** property to retrieve data up to 10 MB. If the data in the response is more 10 MB, an error is displayed.\n-   As data up to 10 MB only can be retrieved, you can also specify number of records that should be retrieved in the input field, **Number of records to return**.\n\n</td></tr><tr><td rowspan=\"4\">\n\nAttack Schedule Management\n\n</td><td>\n\nCreate Attack Schedule\n\n</td><td>\n\nCreates an attack schedule on the Gremlin platform.\n\n</td></tr><tr><td>\n\nDelete Attack Schedule\n\n</td><td>\n\nDeletes the specified attach schedule.\n\n</td></tr><tr><td>\n\nGet Attack Schedule Details\n\n</td><td>\n\nRetrieves details about the specified attack schedule.\n\n</td></tr><tr><td>\n\nLook up Active Attack Schedules\n\n</td><td>\n\nLists all the attack schedules on the Gremlin platform.\n\n</td></tr></tbody>\n</table>**Note:**\n\n-   Time zone that is considered in the spoke actions, is same as the time zone of your ServiceNow instance.\n-   Based on your Gremlin license, if you don't have access to certain Gremlin functionality, you can't use the associated spoke actions in your ServiceNow instance as well.\n-   For some arguments that take `True` or `False` as input, the actual value that the Gremlin platform considers, might be different from the value you have provided.\n\n## Connection and credential alias requirements\n\nIntegration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.\n\nFor information about setting up the spoke, see [Create Connection and Credential record for the Gremlin spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/create-conn-cred-gremlin.md).\n\n"}}