Changelog
Follow up on the latest improvements and updates.
RSS
In October’s update, we’re rolling out improvements to make your workflows smoother and give your team better control over development.
Now, new entries in tables are hidden by default to help you focus on the data that matters most. We’ve also made it easier to edit and copy entries in tables, and the updated property dropdown makes finding and selecting custom properties simpler. Plus, we’ve added a new integration with Orca Security and enhanced other integrations.
New properties will now be hidden by default in tables
New properties are now hidden by default in all tables referencing a blueprint. Properties are only added to the specific table where they’re created or explicitly selected, giving you more control and ensuring you see only relevant information.
Improved Table UI
We're excited to share a small but impactful update to our tables! The edit and copy buttons now appear directly over the existing text on hover, removing unnecessary whitespace. This update keeps your data visible and accessible, so you can make adjustments quickly and intuitively.
Customizing your experience with in-house properties? Now, it is easier to discover your next custom property with the new properties dropdown and categories. This enhancement supports teams in tailoring Port to fit specific needs, making property management more intuitive and organized.
New Integrations
- Orca Security: Now you can pull security issues from Orca directly into your service catalog, giving your team a centralized view of vulnerabilities to monitor and address security concerns. Read the guide.
- Jenkins Pipeline Stages: Visualize Jenkins pipeline stages in your Port catalog to stay updated on your CI/CD workflows without needing to switch platforms. Read the guide.
- GitOps Support for Bitbucket: Sync port.yaml files to enrich service entities in Bitbucket, helping teams using GitOps workflows manage configurations directly in Port. Access the code.
- Azure DevOps Releases: Integrate your Azure DevOps releases into your service catalog to maintain a complete view of your deployment process from one source. Read the guide.
New product guides
As autumn settles in, we're excited to bring you fresh updates from Port. This month, we've made tracking
DORA metrics
simpler than ever, helping your teams measure performance and enhance delivery practices. We've also introduced Action Steps
to make your action forms easier to fill out, improving the user experience when completing forms. But that's not all—there's more to explore. Dive in to discover all the new features we've rolled out!Big
DORA metrics
📊We made it simpler than ever to track DORA metrics in Port! DORA metrics help teams measure their performance and improve delivery practices. Our new guide walks you through setting up and tracking these metrics using your existing tools and processes.
Enhanced DevEx with Action Steps
🧑💻We’ve streamlined the self-service developer experience by introducing
Action Steps
. Now, you can group complex forms into easily manageable steps, making action forms more intuitive and efficient for your team. Learn more in the docs.
Medium
Leverage Secrets in Actions and Automations
🔐Build your custom automated workflows integrating with any API directly with
Secrets Management
in Port! Secrets are securely stored and can now be referenced in your custom actions and automations using {{ secrets.<SECRET_NAME> }}
. Use this feature with the Webhook invocation method to create
no-code, backend-free
automations, seamlessly integrating with any internal or external tools in your stack. For example, See how our own platform team implemented "Page the on-call" action via PagerDuty with no-code. For more details, check out [the docs](https://docs.getport.io/sso-rbac/port-secrets/
Create Service Accounts as users
🤖Service Accounts
are non-human users (bots) that you can use to integrate external tools and automate daily tasks in Port. You can now leverage Port's robust RBAC system by using them. Associate Service Accounts with teams and roles, or mention them directly in permission settings, just like any other user. This means you can securely automate tasks and workflows while maintaining precise control over permissions.
See the docs to learn more.
Note:
Users and Teams as a blueprint
(currently in beta) is required to use this feature. Learn more on Users and Teams and how to enable it.Small
UX updates to the data source definition
- Expandable Sections in Mapping: We've introduced the ability to expand and collapse sections in the mapping editor, making it easier to manage mappings efficiently.
- Follow Logs in the Event Log: When reviewing event logs, performance has been improved to display the latest logs first, helping you quickly find and address issues.
Sync Port service catalog to Incident.io
You can now seamlessly integrate your Port service catalog with Incident.io, enabling better incident tracking and management. Sync your service entities effortlessly to enhance visibility and streamline your incident response process.
Happy end of summer with new release notes from Port. In this edition, we’re continuing to make automations more impactful, with workflows, making it easier to build in Port with guides and adding various capabilities in the creation of the data model and syncing data.
Big
Define advanced workflows
🔗You can now create and trigger multi-step workflows within your developer portal, resulting in advanced automations that chain actions together.
You can choose different automation triggers, such as the status of other actions, Port API, or chain external services.
Examples:
- Start a production incident with PagerDuty, which will then create a Slack channel and share a Zoom link.
- Send a Slack message when a deployment action fails.
- Create a cloud resource using Terraform directly from Port.
Check for examples in our Docs.
New Guides section in docs
📖Explore our updated Guides section for easier access to tutorials and documentation. You can filter guides by use cases, portal functionality, and technologies to find relevant content faster.
Medium
Ingest file contents from Gitlab
Parse specific GitLab metadata content and add it as metadata into the Port software catalog. For example, you can extract dependencies from
package.json
for better visibility or use CODEOWNERS
files to map services to their owners in the Portal. This capability already exists in GitHub. See Docs.Update entities based on a query
You can now update entities by looking up their properties and not just by their identifiers. For example, when enriching entities like
Service
with PagerDuty data, you can use a known property (e.g., PD identifier
) to update the relevant data. This feature is supported across all integrations and the Port API. This reduces the need for multiple blueprints and mirror properties and simplifies catalog ingestion. See Docs.
Data sync status reflection
Easily track the status of your data syncs and keep your catalog current. You can now see when a sync is in progress, when the last sync occurred, and when the next one is scheduled (for integrations with a defined resync schedule).
We've also added a "Resync Now" button on the integration card, allowing you to manually trigger a sync.
Entity card widget
We've introduced a new widget type that lets you display the details of a specific entity within your dashboards. For instance, you can showcase team entity details directly on a Team page or display environment details on a monitoring dashboard, providing users with a more focused and relevant view.
Check our Demo.
Entity sorting in action input forms
↕️You can now define sorting for entities in the action input form, making it easier for developers to find and select the relevant entities. See Docs.
Small
Octopus Deploy integration
You can now sync deployment data from Octopus Deploy into your Port catalog. This integration helps you keep track of deployments and environments, enhancing visibility and control over your deployment processes. See Docs.
Direct links to actions
You can now generate direct links to specific self-service actions in Port, allowing users to access them immediately without navigating through the portal. This is perfect for sharing in Slack channels or internal documents to streamline workflows and enhance accessibility.
UX Update to Actions Quick Menu
We've refined the quick menu to make actions more accessible outside of the menu itself. Now, you can access available actions directly from the table view without needing to open the quick menu, making it faster and easier to interact with entities.
Integration improvements
How are you spending your summer? We’re spending it on making Port better, notably by releasing Port-hosted integrations, which make it simpler to set up Port.
Big
Port-hosted integrations
🌊We are extremely excited to announce the release of "Hosted by Port" Ocean integrations! 🔌 🌊 plug-and-play, installed within minutes, and doesn't require any maintenance on your side.
These integrations come with portal templates. Once you connect them, you will already have a basic internal developer portal, ensuring you’re ready to run and do not have to worry about data models in the initial phase.
To install, choose the "Hosted by Port" installation method when choosing a new data source in the "Data Sources" section of the Builder area.
Managed integrations will be displayed with a "Hosted by Port" tag. See docs.
Personal table view persistency
💾Table views are now persistent so that any portal user can create their own views and filters. Views will be saved for future visits and can be shared as URLs to collaborate with colleagues. This makes using the portal simpler and more personal for your users. See docs
Medium
New action type - send a Slack message
💬Leverage the new “Send Slack message” action type to easily define and drive automatic notifications in Slack, such as alerts or nudges on action items that are past their due date. See docs.
Multiple account support for Ocean cloud providers integration
You can now manage the Port integration with multiple AWS, Azure or GCP accounts in one place, saving you time on copy-pasting configurations and settings. See docs for AWS, Azure and GCP.
Small
Use Port API as a webhook action
You can now use the Port API natively as part of Actions and Automations, allowing you to execute any Port API route you wish with automatic authentication. This is helpful to automate actions that result in changes inside the portal. See docs.
The biggest theme for our first 2024 summer release notes is using the portal for engineering insights. Portals are a natural place to understand everything about the engineering organization: its productivity, agility and standards compliance. This is a result of the fact that the portal is a single source of truth about teams, developers, services and infrastructure and the relationships between them. This new software engineering intelligence capability makes Port more useful to engineering leaders, especially since Port doesn’t just provide insights, but also the power to change behavior, productivity and standards compliance.
Biggest
Historical data trends - engineering insights
Port now supports tracking and visualization of historical data. This is ideal for a variety of what’s called “software engineering intelligence” needs, such as DORA and other engineering productivity metrics, and also useful for any work on standards compliance. We’re thinking of calling this set of capabilities “insights” 💡. Practically you can use it as a line chart widget that displays the history of number properties as trends. Line charts can also visualize the history of aggregation and calculation properties to create a bird's-eye view of custom metrics, like:
- Tracking engineering metrics
- Following the scorecard passthrough rate
- Open critical vulnerabilities trends, and more
See docs to learn more.
Map GitHub file content to the catalog
Bring GitOps to life with json and yaml mapping, enriching your catalog with any data you already have in your repositories:
1. Use JQ to map specific fields to your catalog entities. For example, map the “package manager” from a package.json file to a service entity
2. Create and update multiple entities based on arrays in files. For example, map all dependencies from a package.json as an entity per dependency
See docs to learn how to map file content from GitHub
Medium
Multiple approvers to self-service actions
You can now require more than one approval for an action to be completed, for cases that require multiple approvals. All approvers will get notified for approval and can add a note explaining their decision. See docs to learn more.
Define relations based on any property
When defining relations as part of integration mapping, you can now define the relation using a comparison with any entity property instead of just the identifier. See docs
View permissions at the API level
You can new enforce view permission for entities according to roles, users, specific teams, or dynamic team ownership, which will take effect both on the Port app and when interacting with the API. See docs
Small
Live examples for JQ and Mapping playgrounds
We added a live examples capability when testing the mapping for K8s, GitHub and BitBucket exporters to make the mapping experience much easier
Mirror properties for many-to-many relationships
Mirror and view multiple related entities and their properties.
Use entity context when triggering automation with the timer expired trigger
You can now use entity details for context when defining automations based on their timer expiration trigger. Learn more on how to use trigger context in automations
These release notes mark a significant milestone for Port: automations. Ever since we began developing Port, we knew that the software catalog is at the core of the portal, that it is real-time, and that it contains important context other tools don’t have. The next logical step was leveraging this power for automations, which were possible in Port but complex. These release notes contain the automations feature. It is meant to help you realize the power of the portal. Stay tuned: we have more to do on the automations front, and we will.
Biggest
Automations
⚡️We are excited to unveil our new Automations feature, designed to streamline and enhance your developer workflows. Automations allow you to automatically trigger workflows, alerts, and notifications based on changes within the software catalog, such as a new entity being created, a timer that expired, a scorecard change, or any other change in existing entity data. See docs to learn how to set up your first automation.
AWS and Datadog integrations powered by Ocean
🌊AWS
integration is now better, allowing you to display an accurate, real-time representation of your AWS resources as part of your software catalog and customize the integration in Port. See docs.With the new
Datadog
integration, you can import monitors (also known as alerts), SLOs, and services from your Datadog account into the Port software catalog. See docs.Custom scorecard levels
🚥You can now define custom levels and colors for scorecards. For example, you can use
A-F
levels with stoplight colors. See docs. Medium
Mapping playground for data sources
Creating and tweaking how data sources map to your software catalog is now a much better experience, as we introduced a playground to test your mapping on real examples. See docs.
IaC support improvements
- Terraform data sources:We now support Search API through Terraform, which allows users to apply automation and resource creation based on the software catalog data in Port. See docs
- Integration configurations:You can now manage all organizational integrations from one central location, including Ocean, K8s, and GitHub. For example, in case you manage multiple exporters of the same integration and you want it to have the same mapping, you can now efficiently manage mapping using IaC, setting mapping in a variable file as a single source of truth. See docs
- Actions resource:Updated our actions resource to include customizing the action payload and adding filters on day-2 actions. See docs
- Blueprint permissions:You can now manage Blueprint Permissions. See docs
- Skip catalog page creation when adding a new blueprint:You can now skip catalog page creation during blueprint creation, preventing state discrepancies caused by unintended page creations. This can also be determined when creating a blueprint via the API. See docs
New API docs experience
As an API-first company, we are proud of our API and its capabilities. Today, we improved our API Reference so you can explore, learn, and test the API routes more efficiently than ever. Visit the new API docs
Ability to filter entities for self-service actions
You can now apply filters and conditions to day-2 actions so that they appear only on the relevant entity actions list. See docs.
Small
Delete entities via a webhook integration
You can now delete entities using a webhook integration definition. See docs.
More relevant results in global search
We improved the order in which global search results appear, making it easier to find what you need. See docs
Automatically rotate organization secret
You can now rotate your Port organization secret/s using the UI or the API. See docs
Update/create Port entity invocation type
As part of the automation feature, we added an invocation method to create or update entities in the software catalog based on the automation context or user inputs. This is useful for automating changes based on events in the software catalog or creating self-service actions to update specific properties of an entity utilizing RBAC for self-service actions. See docs.
Our biggest news this month is the GCP integration, allowing you to see all GCP resources in the portal, in context of any other software catalog entity. We’ve also worked on many usability improvements, and added a handy automation feature.
In other news, we also released a simple tool to help you plan your portal roadmap as part of our portal-as-product approach. You can access it here.
Biggest
GCP integration - powered by Ocean 🔌
You can now ingest Google Cloud resources into the software catalog, including projects, container clusters, cloud-run services, BigQuery tables, compute engine autoscaler, and other GCP objects. The integration with GCP supports real-time event processing, which allows for an accurate real-time representation of your Google Cloud infrastructure inside Port. See docs.
Define the self-service action payload
✏️You can now create custom payloads when setting up actions. You can use it to set up self-service actions that can directly connect to existing APIs or pipelines without the need to make adjustments in a separate step. See docs.
Medium
Builder data model view improvements
In the builder tab, we made working on the data model easier:
- Hide blueprints- We now allow hiding blueprints in the data model view, reducing unnecessary visual complexity
- Search blueprints- You can search and discover all blueprints, shown or hidden
Mirror properties improvements
- Mirror aggregation properties- You can use a mirror property to fetch and display aggregation coming from related blueprints
- Search by mirror properties- You can now use mirror properties as part of search queries anywhere search queries are used in Port, such as chart filters or directly in the API
Existing integration improvements
- Azure ocean integration: Manage multiple subscriptions in one installation. You can now manage multiple Azure subscriptions under one installation, significantly reducing the maintenance efforts of your integration. See docs
- Kubernetes exporter: Manage resources using Kubernetes CRDs (See guide) and map each item from an array into your catalog with ItemsToParse(See docs)
Small
Display a single property as a number chart
You can now display a specific entity’s number property in any dashboard with the number chart. For example, get an MTTR metric for a service directly from PagerDuty and display it on the specific entity dashboard. See docs.
Automatically trigger an action on behalf of a user
You can now set an automated workflow by triggering actions automatically on behalf of users. These actions will show up for users on their “my actions” panels. See docs
It’s springtime, and along with the new flowers, leaves and the natural beauty of the season, Port re-branded. In case you haven’t noticed, check out the Port site or your Port developer portal. We also invested in letting you create personalized places for developers where they can easily see what needs to be done, and similar experiences for platform engineers modifying the data model.
Biggest
Brand new Port
↘️We're excited to unveil Port's fresh rebranding. Here’s to our designers Val Burtakov and Ory Zydner, for better expressing what Port is all about, and creating a site and brand that we really love. Have a look.
Change the data model directly in the software catalog
🗒️Instead of working in the builder section of the portal, platform engineers can now make changes to the data model directly in the software catalog. You can now add and edit properties in catalog tables, making data model changes easy and immediately seeing how the changes will be seen by developers.
Medium
Add self-service action as a widget
With the new “Action Card” widget, you can now add self-service actions to your dashboards within its context, creating a holistic developer experience. For example, add a “Rollback Service” action to an incident management dashboard. This reduces context switching and helps make any insight immediately actionable. You can display one or more actions in one widget. Learn more.
Export data from table
You can now download a specific table view as a CSV or JSON file for further use.
Small
Search in catalog pages
We’ve added a new sidebar search so you can easily find the catalog page you need.
Map each item from an array with
ItemsToParse
in Ocean integration
Create and update entities based on any array in an incoming event. Learn more
Gitlab Ocean integration - granular webhooks
The Gitlab Ocean integration now allows the creation of webhooks on specific groups and choosing which branch to listen to.
The biggest item in February’s release notes is Folders. Folders play a key role in realizing our portal-as-product approach, since they allow platform engineers to provide the right experience by developer, team, and manager. Folders let you group portal elements in a way that makes immediate sense to users and only provide them with what they need for a given use case. Additional items this month also focus on improving portal experiences, from the ability to add page and dashboard descriptions to action run status labels.
Biggest
Create developer experiences using Folders
📁We are excited to announce the release of folders!
- Folders allow you to customize the Port sidebar, grouping portal elements by use case, persona, team, etc. By organizing your portal with folders, Port becomes a space that feels specifically designed for any developer workflow.
- A folder can include dashboards, catalogs, or additional sub-folders up to three levels deep. This flexibility allows for a structured and clear organization of the portal's resources and should be done to simplify the portal for users.
- You can expose users to specific folders by setting permissions for pages inside them.
Azure DevOps integration powered by Ocean
🔌This Ocean-powered integration makes it easier to integrate Azure DevOps by adding Projects, Repositories, Pull requests, Repository policies, Pipelines, Teams and Members to your catalog. Learn more.
---------------------------------------------------------
Medium
Quickly debug your integrations with live event logs
You can now view live event logs coming from Ocean integrations. These events contain valuable details for debugging your integration, such as the current status of the ocean container, resync process, and integration startup.
The new event log view is available for all Ocean integrations on the “Data sources” page.
Action run status label
You can now add a custom label to the action run status to reflect any step in the action process. These will be shown as part of the action run status card panel. Learn more.
Pages description
Add descriptions to pages and dashboards to make them easier to understand and search. Descriptions can be added when creating or editing the page or using the API.
Improvements in existing integrations and guides
- K8s exporter - we reintroduced the ability to maintain your catalog data based on ConfigMap
- SonarQube Ocean integration - we added support for on-premise analysis, leveraging PR and Measures API from SonarQube
- Pagerduty Ocean integration - we added support for analytics on the service blueprint
- BitBucket Server integration - our Python script now supports filtering specific projects to ingest from your Bitbucket environment
- New cloud resources permissions guide - see this new comprehensive guide on how to implement IAM and Cloud resources in port
---------------------------------------------------------
Small
Load entity example when testing JQ
When testing JQ expression for a new calculation property, you can now load an existing entity example to test with real scenarios.
Actions and scorecards Audit Log
See changes in actions and scorecards definitions using the Audit Log page.
User form Boolean input is now a toggle
For a better user form experience, we now support a toggle form input type. Note that “Select” input type is still available for cases where more than True/False is needed.
Terraform and Pulumi support for page permissions
New GitHub actions
- You can now use our provided Github action to delete a Github repo
- With the new Ocean Sail GitHub action, you can quickly and easily configure an Ocean integration to run as part of your GitHub workflow.
Biggest
Jenkins
visualize your CI/CD pipelines by adding views for Jenkins jobs, builds, and users. Install integration here. See docs here.
Wiz
provide developers and security engineers with a centralized view of their Wiz controls and issues. Install integration here. See docs here.
--------------------------------------------
Mediums
Improvements in existing integrations
- All Ocean integrations now support installation using ArgoCD. Learn more.
- Snyk - Added a new feature to auto-discover all groups and organizations associated with the Snyk ocean integration. Learn more.
- ArgoCD - added support for ingesting ArgoCD deployment history into Port. Learn more.
- Terraform cloud - added for support ingesting organization into Port. Learn more.
- Kubernetes - added for support ingesting Kyverno policies into Port. Learn more.
- AWS - added support for ingesting AWS ECR images into Port. Learn more.
- AWS cost - added support for ingesting AWS cost using a GitLab Pipeline. Learn more.
- JFrog - added support for ingesting artifacts and repositories into Port. Learn more.
- GitHub - added support for ingesting GitHub users and GitHub packages into Port.
- Bitbucket Server - use our script to easily ingest README.md files in every repository and display them in Port as a Markdown page.
Pre-made GitHub actions
Use these actions to create self-service actions for your developers - provision Azure resources, trigger Datadog incidents
--------------------------------------------
Smalls
JQ errors in the UI
To make it easy to debug issues when writing JQ, we now display JQ error messages when trying to test or save invalid JQ.
Enhanced search capability for tables
The table “free search” capability has improved and now supports searching each word separately instead of the entire search term.
JSON edit mode for self-service actions
When creating/editing self-service actions, you can now switch to “JSON mode” instead of the editing form.
Terraform provider enhancements
We enhanced the Terraform provider by adding support for - aggregation properties, and the “required” JQ setting for self-service actions.
Builder section is no longer in-view for Members
In order to create a more seamless experience for Port Members, the "Builder" tab is now hidden for them.
Load More
→