In order to disambiguate who Prismatic's customers are, and who your customers are, we refer to Prismatic's customers as organizations and your customers as customers. For example, if you work for a company that develops project management software for rocket companies, your organization may be "Progix Software" with customers like "Rockets, Inc" and "Eastern Spaceflight".
Your organization can contain integrations for all of your products, and team members from multiple departments within your company can access the integrations you create. Your team members can be assigned roles, so your DevOps team members might have administrator access, while your support team might have permission to review integration logs.
Creating Your Organization
Prismatic is currently in private beta. To create an organization within Prismatic, please request private beta access.
For large organizations with multiple distinct divisions, consider creating an organization per division.
If your company has already created an organization, ask your organization's administrator to create a user account for you instead. Registering with Prismatic again will create a second organization.
After creating your organization, you will see a sample integration aptly named "Sample Integration" to help you get started with Prismatic. Feel free to delete the sample integration and create your own if you prefer.
Editing Your Organization
- Web App
To edit any settings of your organization, click the Settings link on the left-hand sidebar. From this screen you can manage team members, configuration variables, credentials, alerting, and organization settings.
The name and avatar icon of your organization can be changed from the Settings tab. Your avatar icon will likely be your company's logo. Avatars are cropped and resized to 512 x 512 pixels, and must be an image. Transparent square PNG images tend to look the best.
Managing Organization Users
After creating your organization, you can create accounts for your team members so that they can create and maintain integrations for your customers. Click the Settings link on the left-hand sidebar, and select the Team Members tab. Click the + Team Member button to create a new user. Select an appropriate role for your team member, and enter their name and email address. Once you create your team member's account, they will receive a confirmation email and registration link to set their password and personal information.
For More Information: Users
Organization Configuration Variables and Credentials
Configuration variables and credentials are commonly used values (rest endpoints, API keys, etc.) that are referenced by your integrations. For example, several integrations might rely on AWS keys to access an S3 bucket - the organization credential store is an appropriate place to save those.
When Should I Use Organization-level Config Vars or Credentials?
Organization-level config variables and credentials can be referenced by multiple integrations, and should be generic to all customers. Customer-specific credentials and configuration variables should be saved at the customer level.
For example, if there is an API endpoint that all customers and multiple integrations use, that endpoint should be saved as an organization-level configuration variable. On the other hand, if a configuration variable is customer-specific, or integration-specific, the config variable should be saved on the customer or integration.
Managing Organization Configuration Variables
Reusable key-value config variables can be set at the organization level. To update organization-level config variables, click the Settings link on the left-hand sidebar, and then select the Config Variables tab.
If you have a more complex config variable value that you would like to enter, like a section of HTML, JSON object, or XML block, click theicon to the right of a config var to open a code editor.
Managing Organization Credentials
Credentials save login information (API keys, OAuth credentials, etc.) for integrations. Credentials are used by instances of integrations to interact with login-protected resources (Dropbox, AWS, SFTP servers, etc.). To add or edit credentials, click the Settings link on the left-hand sidebar, and then select the Credentials tab.
For information on the types of credentials you can create, see authorization methods. To walk through a sample integration that uses configuration variables and credentials see this quickstart guide.
Creating Alert Groups
When instances of integrations behave unexpectedly, you likely want to be notified. For example, you may want your DevOps team to be alerted when an instance of an integration fails to run to completion. An alert group is a set of users to notify and webhooks to invoke when an alert trigger fires.
To create or modify alert group, click the Settings link on the left-hand sidebar, and then select the Alert Groups tab. Click the +Alert Group button to create a new alert group, and enter users to notify and webhooks to invoke in the even of an alert trigger.
For More Information: Monitoring and Alerting
Using Alert Webhooks
In addition to email and text alerts, you can configure alert monitors to invoke a webhook with a payload of your choice. To create or modify a webhook URL, click into the Settings page and select the Alert Webhooks tab. Click the +Alert Webhook button, enter an appropriate name for your alert webhook, and enter URL, header, and payload information for your webhook.
Alert webhooks can be used to invoke the PagerDuty API, your own DevOps alert endpoint, or any other alerting service with an HTTP-based API.
For More Information: Monitoring and Alerting
Tracking Service Utilization
You can track metrics about your organization's usage of Prismatic services from the Utilization tab of the Settings page. On this page, you can view details about:
- Instance and integration counts
- Blog storage usage
- Instance execution count
- Customer and user counts
- Step Execution counts
- Execution speed
Additionally, you can view metrics from this week and last week to help identify changes and anomalies.
When you first sign up for Prismatic, you are entered into the "free plan" so you can try assembling and deploying a few integrations before paying for it. To view information on pricing, see our pricing page.
To manage billing within the web app, click Settings on the left-hand sidebar, and then open the Billing tab. From there you can update credit card and other billing information.
Please reach out with any questions about billing.