For repository setup instructions for v1.5, see Organization (Admin Settings v1.5).
Select the Repositories tab in Admin Settings to display the list of all system repositories. Click on the Active and Inactive buttons to change the repository status.
A default repository can be specified so that each time you log into XRay, the default repository’s data will load. This is a user-based setting. See Manage Settings for more information.
To learn about dashboards for repositories, see Repository Dashboards.
Create a repository
On the Repositories tab, click the Create button to add a new repository to the system. Review the settings in the table below. Click Create to create the new repository.
| Field | Description |
| Aggregate Retention | Defines the length of time, in seconds, that aggregated data stored in Datasets table as the result of View evaluations is kept, after which it is deleted from database. |
| Daily Stream Bytes | Number of bytes that can be streamed per calendar day. |
| Daily Stream Messages | Total number of individual messages that can be streamed per calendar day. |
| Data Points | Defines the total number of data points (total number of Activities, Events, and Snapshots) that can be stored in the data store at any one time (based on Retention). |
| Max Message Size | Defines the maximum number of bytes that is stored in the Message field of Events (generally represents the payload of the data involved in the Event). |
| Max Property Value Rollup | Deprecated. |
| Max Tokens | The maximum number of Access Tokens that can be defined in the entire system (for Master License) or in a specific organization (for Default or organization-specific license) |
| Rate Limit Bytes | Controls the rate at which your data is processed. This is a limit on the number of bytes per second. |
| Rate Limit Count | Defines the maximum streaming rate, in messages per second, which data can be sent to the system. If data comes in at a higher rate, the defined Overage Policy will be applied to the connection. |
| Retention |
Defines the length of time, in seconds, that data is kept. When the Retention time expires, the data is deleted from the database. 5,184,000 seconds = 60 days 604,800 seconds = 7 days |
| Overage Policy |
Defines what action is taken when the streaming rate exceeds either Rate Limit Bytes or Rate Limit Count: THROTTLE – the connection is throttled so that the processing rate on the connection is the minimum of RateLimitBytes and RateLimitCount DROP – messages are dropped until the streaming rate slows down to the limits defined by RateLimitBytes and RateLimitCount ALLOW – no action is taken, and the streaming is allowed to continue at the current rate |
Repository Dashboards
To configure a repository dashboard’s teams, click the setup icon in the dashboard column. The list of dashboards for the repository is displayed. The assigned teams for each dashboard are included.
Search fields are provided at the top of the Name and Source columns. Click an entry to edit it.
Assign a new team to a dashboard
- Click the setup
icon for the team.
- To assign a team or teams, enter the team name select in the Teams field at the top of the page.
- Using the Role list, choose whether you want the team to be able to view the dashboard only (View) or view and modify it (Modify).
- Click Assign.
Edit a repository
- Click the edit
icon for the repository.
- Make your changes.
- Click Save.
Clone a repository
To create a new repository based on an existing repository, use the clone function.
- Click the clone icon
for the repository you want to copy.
- Enter a name for the new repository.
- Make any other desired changes.
- Click Create..
Delete a repository
- Click the delete
icon for the repository you want to remove.
- Click Yes at the confirmation message. The repository is removed.